Time Properties [time]

This request sets various Network properties.

URL:

/set.cgi?dst=time&<optional-parameters>

Optional Parameters:

  • ntpList=<string> (optional)
    • This parameter (if present) sets the device’s list of NTP servers.
    • This parameter should not be used if the time is being set manually.

  • year=<1900..2199> (optional)
    • This parameter (if present) sets the device’s clock’s year.

  • month=<1..12> (optional)
    • This parameter (if present) sets the device’s clock’s month.

  • day=<1..31> (optional)
    • This parameter (if present) sets the device’s clock’s day.

  • hour=<0..23> (optional)
    • This parameter (if present) sets the device’s clock’s hour.

  • minute=<0..59> (optional)
    • This parameter (if present) sets the device’s clock’s minute.

  • second=<0..59> (optional)
    • This parameter (if present) sets the device’s clock’s second.

  • timeZone=<timeZone> (optional)
    • This parameter (if present) sets the device’s time zone.
    • The time zone string must be from the tzdatabase (i.e.: “America/New_York”).

Response:

A single byte is returned. The following table explains the possible return values.

Result Description
0x00 The operation was successful.
0xFF A required parameter was missing (i.e.: month was given but day was not)

Examples:

Function URL
Set the time manually to 6/30/2017 1:00:42 PM /set.cgi?dst=time&year=2017&month=6&day=30&hour=13&minute=0&second=42
Set the time via list of NTP servers /set.cgi?dst=time&ntpList=pool0.ntp.org%0Dpool1.ntp.org%0Dpool2.ntp.org
Set the time zone /set.cgi?dst=time&timeZone=America%2FNew_York