Date and Time Format

Creating and updating objects

All dates and timestamps submitted through the API when creating or updating objects must follow the W3C DateTime format.

Complete date:

YYYY-MM-DD (e.g. 1997-07-16)

Complete date plus hours, minutes, and seconds:

YYYY-MM-DDThh:mm:ssTZD (e.g. 1997-07-16T19:20:30+01:00)

The format includes information about the user’s timezone. The API also has its own timezone, which you specify when configuring the API. When the user’s timezone is different from the API’s timezone, the user’s time is converted to the API’s time.

The API module also supports date and time format using Z as the zone designator for the zero UTC offset:

For example, 1997-07-16T19:20:30Z equals 1997-07-16T19:20:30+00:00 and 1997-07-16T19:20:30-00:00.

Filtering conditions in POST requests

Filtering conditions for POST requests support short date formats:

YYYY (e.g. 1997)

YYYY-MM (e.g. 1997-07)

YYYY-MM-DD (e.g. 1997-07-16)

For details, see Retrieving Objects (POST), Retrieving Object Classification Values (POST), Retrieving Object Activities (POST).