Clock

Clock configures the system timezone and daylight saving time (summer time) on NX-OS devices. The timezone setting defines the local time offset from UTC, while summer time automatically adjusts the clock forward during specified periods of the year.

Diagram

Classes

system (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
clock	Class	[clock]	No

clock (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory	Default Value
format	Choice	24hours, 12hours	No
format_show_timezone_debug	Boolean	true, false	No
format_show_timezone_syslog	Boolean	true, false	No
protocol	Choice	unspecified, ptp, ntp, none, gnss	No
timezone_name	String		No
timezone_hours	Integer	min: -12, max: 14	No
timezone_minutes	Integer	min: 0, max: 59	No
summer_time	Class	[summer_time]	No

summer_time (nxos.devices.configuration.system.clock)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
offset_minutes	Integer	min: 1, max: 1440	No
start_week	Integer	min: 1, max: 5	No
start_day	Choice	Sun, Mon, Tue, Wed, Thu, Fri, Sat	No
start_month	Choice	Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec	No
start_time	String		No
end_week	Integer	min: 1, max: 5	No
end_day	Choice	Sun, Mon, Tue, Wed, Thu, Fri, Sat	No
end_month	Choice	Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec	No
end_time	String		No

Examples

Example 1: Set timezone to US Pacific Standard Time

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          clock:
            timezone_name: PST
            timezone_hours: -8
            timezone_minutes: 0

Example 2: Timezone with daylight saving time (US Pacific)

nxos:
  devices:
    - name: SPINE1
      configuration:
        system:
          clock:
            timezone_name: PST
            timezone_hours: -8
            timezone_minutes: 0
            summer_time:
              name: PDT
              offset_minutes: 60
              start_week: 2
              start_day: Sun
              start_month: Mar
              start_time: "02:00"
              end_week: 1
              end_day: Sun
              end_month: Nov
              end_time: "02:00"

Example 3: Central European Time with summer time

nxos:
  devices:
    - name: BORDER1
      configuration:
        system:
          clock:
            timezone_name: CET
            timezone_hours: 1
            timezone_minutes: 0
            summer_time:
              name: CEST
              offset_minutes: 60
              start_week: 5
              start_day: Sun
              start_month: Mar
              start_time: "02:00"
              end_week: 5
              end_day: Sun
              end_month: Oct
              end_time: "03:00"