Date/Time Format

Date/time values are found both as inputs and outputs in multiple places in the API.

Output

We use ISO 8601 format including milliseconds for all output values. Here's an example showing standard date/time output formatting:

{
  "query": {
    "name": "body-position",
    "start-date": "2023-06-25T17:04:02.000Z",
    "end-date": "2023-06-25T17:04:03.000Z",
    //...
  }
}

Input

When a date/time is required as an input to an API endpoint, you may use a variety of formats.

[DATE_TIME] must be a string value representing a date, parsed and interpreted using the same algorithm implemented by Javascript's Date.parse()

Examples include:

ISO 8601, no milliseconds:

GET https://api.radiantdrift.com/body-position/2023-06-25T17:04:02Z/[...]

ISO 8601, with milliseconds:

GET https://api.radiantdrift.com/body-position/2023-06-25T17:04:02.555Z/[...]

Date string:

GET https://api.radiantdrift.com/body-position/01%20Jan%201970%2000:00:00%20GMT/[...]

See date time string format for caveats on using different formats.