This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Timestamp formats

Timestamps may be absolute or relative to the implied day. Milliseconds are optional.

The absolute timestamp format is:

yyyy-MM-dd’T’HH:mm:ss.SSSZ

The relative timestamp format is:

HH:mm:ss-hh:mm

When you include an ISO 8601 date in an endpoint URL query parameter, you must URL encode the special characters "+" and "-" signs in the date format.

For example, the "+" in the date 2020-01-01T14:13:12.000+0400 must be escaped to 2020-01-01T14:13:12.000%2B0400.

For more information about URL encoding, see the IETF URI standard.