A DateTime field represents a specific date and time.

Input format

A DateTime value is specified as a string in YYYY-MM-DD HH:MM:SS@timezone format, where @timezone is optional and if given, should be a valid timezone string. If not provided, it will be the timezone of the current actor (user or application), unless overridden via the timezone parameter. Examples:

2014-01-01 00:00:00
2014:04-29 15:38:27
2014-12-31 23:59:59
2014-01-01 00:00:00@Europe/Amsterdam
2014-01-01 00:00:00@Europe/London
2014-01-01 00:00:00@UTC
2014-01-01 00:00:00@Europe/Moscow

Output format

In JSON output, a DateTime value is returned as a string in YYYY-MM-DD HH:MM:SS format. The timezone is equal to the timezone for the current actor, unless a different timezone is specified as a parameter to the request. The following exmaples correspond to the above input format examples, where the actor’s timezone is Europe/Amsterdam:

   "2014-01-01 00:00:00",
   "2014:04-29 15:38:27",
   "2014-12-31 23:59:59",
   "2014-01-01 00:00:00",
   "2014-01-01 01:00:00",
   "2014-01-01 01:00:00",
   "2013-12-31 21:00:00"