Date and time formats
Date and Time Format
Dashdoc uses the ISO 8601 standard for all date and time fields. Depending on the context, the format can include a date, a time, or both.
All date-time values must be valid ISO 8601 strings.
Accepted formats
Date only:
yyyy-mm-dd
Example:2025-06-05
Date and time (UTC):
yyyy-mm-ddThh:mm:ssZ
Example:2025-06-05T14:30:00Z
The trailing Z
indicates that the time is expressed in UTC. When using time zones, only UTC (Z
) is currently supported.
Time only:
hh:mm
Example:14:30
Only for time specific field
Common Errors
Invalid format Dates or times not following the ISO 8601 standard will be rejected. Example of invalid formats:
05/06/2025
(should be2025-06-05
)14:30:00
without a date or timezone (use2025-06-05T14:30:00Z
)
Missing timezone in datetime When providing both date and time, the string must end with
Z
to indicate UTC. Incorrect:2025-06-05T14:30:00
Correct:2025-06-05T14:30:00Z
Hard coded time zones Do not include time zone offsets like
+01:00
. If you do, every time there is a time change, you will need to update your code manually.
Last updated
Was this helpful?