3.2.43. Time Parameters Command Class, version 1¶
\requirement{CC:008B.01.00.32.001}{0}
The Time Parameters Command Class is used to set date and time in a device hosting this facility. However, it is RECOMMENDED to use Time Command Class, version 3 or higher.
\requirement{CC:008B.01.00.33.001}{0}
Time zone offset and daylight savings MAY be set in the Time Command Class.
The data formats are based on the International Standard ISO 8601.
\requirement{CC:008B.01.00.32.002}{0}
Legacy devices that do not support Time Command Class V2 or do not have other means of programming the Time Zone Offset SHOULD be set with the Local Time instead of UTC.
3.2.43.1. Time Parameters Set Command¶
This command is used to set current date and time in Universal Time (UTC). Be aware that the communication overhead may be significant in case routing is necessary thus the time set might be slightly shifted.
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|---|---|---|---|---|---|---|---|
Command Class = COMMAND_CLASS_TIME_PARAMETERS (0x8B) |
|||||||
Command = TIME_PARAMETERS_SET (0x01) |
|||||||
Year 1 |
|||||||
Year 2 |
|||||||
Month |
|||||||
Day |
|||||||
Hour UTC |
|||||||
Minute UTC |
|||||||
Second UTC |
|||||||
Year (16 bits)
Specify the year in the usual Gregorian calendar. The first byte (Year 1) is the most significant byte.
Month (8 bits)
Specify the month of the year between 01 (January) and 12 (December).
Day (8 bits)
Specify the day of the month between 01 and 31.
Hour UTC (8 bits)
Specify the number of complete hours that have passed since midnight (00..23) in UTC or Local Time.
Minute UTC (8 bits)
Specify the number of complete minutes that have passed since the start of the hour (00..59) in UTC. Minutes are measured in Universal Time (UTC).
Second UTC (8 bits)
Specify the number of complete seconds since the start of the minute (00..59) in UTC. Seconds are measured in Universal Time (UTC).
3.2.43.2. Time Parameters Get Command¶
This command is used to request date and time parameters.
The Time Parameters Report Command MUST be returned in response to this command.
This command MUST NOT be issued via multicast addressing.
A receiving node MUST NOT return a response if this command is received via multicast addressing. The Z-Wave Multicast frame, the broadcast NodeID and the Multi Channel multi-End Point destination are all considered multicast addressing methods.
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|---|---|---|---|---|---|---|---|
Command Class = COMMAND_CLASS_TIME_PARAMETERS (0x8B) |
|||||||
Command = TIME_PARAMETERS_GET (0x02) |
|||||||
3.2.43.3. Time Parameters Report Command¶
This command is used to advertise date and time.
7 |
6 |
5 |
4 |
3 |
2 |
1 |
0 |
|---|---|---|---|---|---|---|---|
Command Class = COMMAND_CLASS_TIME_PARAMETERS (0x8B) |
|||||||
Command = TIME_PARAMETERS_REPORT (0x03) |
|||||||
Year 1 |
|||||||
Year 2 |
|||||||
Month |
|||||||
Day |
|||||||
Hour UTC |
|||||||
Minute UTC |
|||||||
Second UTC |
|||||||
Refer to description under the Time Parameters Set Command.