# Date and time formats

### Date and Time Format

Dashdoc uses the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) standard for all date and time fields. Depending on the context, the format can include a date, a time, or both.

{% hint style="warning" %}
All date-time values must be valid ISO 8601 strings.
{% endhint %}

### **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`

{% hint style="success" %}
The trailing `Z` indicates that the time is expressed in UTC. When using time zones, only UTC (`Z`) is currently supported.
{% endhint %}

* **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 be `2025-06-05`)
  * `14:30:00` without a date or timezone (use `2025-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.