Datetime

Feature Support
Sending no
Receiving yes
Config yes

Supported Brands

None

Sender Arguments

None

Config

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
{
   "devices": {
      "datetime": {
         "protocol": [ "datetime" ],
         "id": [{
            "longitude": "4.895167",
            "latitude": "52.3702157"
         }],
         "year": 2014,
         "month": 4,
         "day": 9,
         "hour": 21,
         "minute": 4,
         "second": 23,
         "dst": 1
      }
   }
}
Option Value
longitude valid longitude
latitude valid latitude
year 0 - XXXX
month 1 - 12
day 1 - 31
hour 0 - 24
minute 0 - 60
second 0 - 60
dst 0 - 1

Optional Settings

GUI Settings

Setting Default Format Description
gui-show-datetime 1 1 or 0 Show or hide the datetime protocol in the GUIs
gui-datetime-format HH:mm:ss YYYY-MM-DD see below Datetime formatting

Formatting

Input Output
M, MM Month Number (1 - 12)
MMM, MMMM Month Name (In currently language set by moment.lang())
D, DD Day of month
DDD, DDDD Day of year
dd, dd, ddd, dddd Day of week (NOTE: these formats only make sense when combined with “ww”)
e Day of week (locale) (NOTE: these formats only make sense when combined with “ww”)
E Day of week (ISO) (NOTE: this format only make sense when combined with “WW”)
w, ww Week of the year (NOTE: combine this format with “gg” or “gggg” instead of “YY” or “YYYY”)
W, WW Week of the year (NOTE: combine this format with “GG” or “GGGG” instead of “YY” or “YYYY”)
YY 2 digit year (if greater than 68 will return 1900’s, otherwise 2000’s)
YYYY 4 digit year
gg 2 digit week year (if greater than 68 will return 1900’s, otherwise 2000’s)
gggg 4 digit week year
GG 2 digit week year (ISO) (if greater than 68 will return 1900’s, otherwise 2000’s)
GGGG 4 digit week year (ISO)
a, A AM/PM
H, HH 24 hour time
h, hh 12 hour time (use in conjunction with a or A)
m, mm Minutes
s, ss Seconds
S Deciseconds (1/10th of a second)
SS Centiseconds (1/100th of a second)
SSS Milliseconds (1/1000th of a second)
Z, ZZ Timezone offset as +07:00 or +0700
X Unix timestamp
LT, L, LL, LLL, LLLL Day of year

To use formatting, use the option format in the GUI section of configuration

Example

1
2
3
4
5
6
7
{
   "datetime": {
      "name": "Time",
      "group": [ "Group" ],
      "format": "HH:mm:ss"
   }
}

In this example, only the time is showed in the GUI (24h notation)