Date Formats
Discussion
All dates in the API are in unix epoch time, which is the number of seconds since midnight UTC January 1st, 1970. The API does not accept or return fractional times, everything should be rounded to the nearest whole second.
The fromdate
and todate
parameters are accepted by many methods, and are always dates. min
and max
parameters may accept dates, depending on the sort
used.
For convenience when doing ad-hoc queries without a key
an alternative date format is accepted: YYYY-MM-DD HH:MM:SS
, where
the hour, minute, and second values are optional. Applications should not ship using this date format (as all applications should ship with a key), it is provided just to ease rapid development.
All dates returned by the API are in properties ending _date
. The documentation console indicates these with , hovering
over them will show a human readable version.