Date and Time Format

How Perspio handles dates and times.

Perspio handles the format of all date and time fields as defined by the ISO8601 Date and time format which has the following general principles:

  • ISO 8601 represents date and time by ordering them from the largest to the smallest unit of time: year, month, day, hour, minute, second, and milliseconds
  • Each date and time value has a fixed number of digits that must be padded with leading zeros.
  • A valid string requires a Date Part but Time Part is optional.

Perspio will generally interface with the following two formats:

📘

Date and Time Example

2016-06-01T12:00:00.111Z (YYYY-MM-DD T HH:MM:SS.sss Z)

📘

Date Example

2022-03-01 (YYYY-MM-DD)

The timezone within all requests and responses should be considered as UTC except where explicitly mentioned.