Skip to content

Date and time representation

Points in time MUST be represented in the format defined by ISO 8601. It MUST contain a timezone definition, however adjustment to UTC is not required. The timezone SHOULD be semantically match the context.

Example

{"eventName": "Racing challenge 2020",
 "location": {"name": "Daytona International Speedway"},
 "date":"2020-06-16T14:30:00-04:00"}

Note how the timezone is matching the location.

Date of day representation

If the point in time refers to a specific day only where time does not matter, for example a birth date, it MUST NOT be represented with a time implication, as it is the case for Unix timestamps for example.

Good example

{"expiry":"2020-10-18"}

Bad example

{"dateOfBirth":"1980-12-21T00:00:00Z"}
{"expiry":1529352524}