Dates and times

The Asana API uses the ISO 8601 date time format for endpoints that return or accept date and time values.

Date-only values

For values that are dates without a time, such as a task's due_on field, the format will be the date-only ISO 8601 format YYYY-MM-DD.

Date and time values

The ISO 8601 format YYYY-MM-DDTHH:mm:ss:fffZ is used for fields that return or accept date and time values.

Date Part	Description
`YYYY`	Four-digit year (e.. 2024)
`MM`	Two-digit month (01 = January, 02 = February, ..., 12 = December)
`DD`	Two-digit day of the month (01 through 31)
`T`	Separator indicating the start of the time component
`HH`	Two-digit hour in 24-hour format (00 through 23)
`mm`	Two-digit minute (00 through 59)
`SS`	Two-digit second (00 through 59)
`fff`	Three-digit fractional seconds (000 through 999)
`Z`	Indicates Coordinated Universal Time (UTC)

Examples

A task's due_on field may return a date-only value such as 2024-05-27. This value represents May 27, 2024.
A task's created_at field may return a value such as 2024-05-24T19:50:18.053Z. This value represents May 24, 2024, at 7:50 PM UTC, plus 18 seconds and a fractional value of 0.053 seconds.

API Query example

Some API endpoints accept a date/time value as a query param. One example is the GET /tasks endpoint that accepts a modified_since query param to filter tasks that have changed since a given date/time. To query tasks in the project with an GID of 123456 that have been modified since May 24, 2024 at 4:00 PM UTC, the API call would look like the following.

GET https://app.asana.com/api/1.0/tasks?project=123456&modified_since=2024-05-24T16:00:00.000Z