set time

Purpose

Sets the Coordinated Universal Time (UTC) and/or system time and date on a Digi device.

All Digi devices maintain time and date as the UNIX epoch (00:00:00, January 1, 1970) plus device up-time. On devices with no real‑time clock (RTC), date and time revert to the UNIX epoch on each reboot or power-cycle. On devices with a RTC, date and time is the UNIX epoch plus time since initial power-up.

On a Digi device with no real-time clock and no configured clock source, time and date are completely local to the device and have limited usefulness since they are not persistent over reboots/power-cycles.

On a device with a RTC and no configured clock source, time and date are also local to the device, but they are meaningful because they are persistent.

On a device with a configured clock source, time and date received from a clock source are expected to be UTC.

Syntax

set time [options]

Options

time=hh:mm:ss|hh:mm

The time. Hours can range from 00 to 23, minutes can range from 00 to 59, and seconds can range from 00 to 59. If omitted, all default to 00.

date=mm.dd.yy

The date. Month can range from 01 to 12, day can range from 01 to 28, 29, 30, or 31, depending on the month and leap year, and year can range from 00 to 36, representing the years 2000 through 2036.

timezone=string

Enter the time zone name, such as CST6CDT or Chicago.

ntp_enable=on|off

Enable or disable time server synchronization.

serverN=ntp server name

The name of the NTP server, where N is the server number.

N=server index [1-4]

Specify the number of the NTP server.

Example

Set NTP server #1 to 0.time.digi.com

#> set time server1=0.time.digi.com

Set the date and time to 2:15 PM, April 3, 2008

#> set time time=14:15 date=04.03.08