Building a timeline
ISO 8601 dates explained
Short answer
- Current part
- ISO 8601-1:2019, Basic rules, published February 2019 1
- Amendment
- ISO 8601-1:2019/Amd 1:2022 1
- Last review
- Reviewed and confirmed in 2024 1
- Complete date
- YYYY-MM-DD, for example 1997-07-16 3
- Web profile
- RFC 3339, July 2002 2
What the standard covers
ISO 8601-1:2019 has the title Date and time, Representations for information interchange, Part 1, Basic rules 1. ISO says it specifies representations of dates of the Gregorian calendar and times based on the 24-hour clock, and that it applies to times and time shifts based on Coordinated Universal Time 1.
The standard leaves some things out. ISO lists date elements from non-Gregorian calendars, times not based on the 24-hour clock and character encoding as outside its scope 1. The first edition of Part 1 was published in February 2019, was reviewed and confirmed in 2024 and has a 2022 amendment 1.
The basic patterns
A W3C note from 1997 sets out a simple profile of ISO 8601 3. It shows six levels of precision, from a year alone to a time with fractions of a second 3.
| Precision | Pattern | Example |
|---|---|---|
| Year | YYYY 3 | 1997 3 |
| Year and month | YYYY-MM 3 | 1997-07 3 |
| Complete date | YYYY-MM-DD 3 | 1997-07-16 3 |
| Date, hours and minutes | YYYY-MM-DDThh:mmTZD 3 | 1997-07-16T19:20+01:00 3 |
| Date and seconds | YYYY-MM-DDThh:mm:ssTZD 3 | 1997-07-16T19:20:30+01:00 3 |
| Fraction of a second | YYYY-MM-DDThh:mm:ss.sTZD 3 | 1997-07-16T19:20:30.45+01:00 3 |
Time zones and offsets
The W3C note defines the time zone designator as Z or +hh:mm or -hh:mm 3. Z means UTC. An offset says how far local time is ahead of or behind UTC 3. Its example is 1994-11-05T08:15:30-05:00, which is 8:15:30 a.m. on 5 November 1994, US Eastern Standard Time, and the same instant as 1994-11-05T13:15:30Z 3.
RFC 3339 adds a rule for an unknown local offset. Where the time in UTC is known but the local offset is not, it can be written with an offset of -00:00 2. The RFC says Z or +00:00 imply that UTC is the preferred reference point for the time 2.
RFC 3339 for internet records
RFC 3339, Date and Time on the Internet, Timestamps, was published in July 2002 by G. Klyne and C. Newman 2. Its abstract calls it a profile of the ISO 8601 standard for dates and times using the Gregorian calendar 2. It is a Proposed Standard and has been updated by RFC 9557 2.
The RFC joins a full date and a full time with the letter T, and its note allows a space in place of the T for readability 2. It says that as the parts run from least precise to most precise, date and time strings may be sorted as strings, provided zones and fractional digits match 2.
Why it matters for a dated record
Written dates such as 03/04/2026 can mean 3 April or 4 March depending on the reader. A YYYY-MM-DD string removes that doubt and sorts correctly 2,3. For a timeline, store the date in ISO form, keep the reduced precision when the source gives only a year or a month, such as 2024-03, and record the offset when the source gives a time 3.
Common questions
What is the ISO 8601 date format?
A complete date is written YYYY-MM-DD, for example 1997-07-16 3.
What does the Z at the end of a time mean?
Z marks UTC. An offset such as +01:00 or -05:00 shows the difference from UTC 3.
Is RFC 3339 the same as ISO 8601?
RFC 3339 describes itself as a profile of ISO 8601 for internet timestamps 2.
Which version of ISO 8601 is current?
ISO 8601-1:2019, with Amendment 1 of 2022. ISO says it was reviewed and confirmed in 2024 1.
Can I write a date with only a year and month?
Yes. The W3C profile allows YYYY-MM, for example 1997-07 3.
Rules and charges change. Check the official source linked on this page before you pay or travel. Spotted an error? Email hello@datedrecord.com.
Sources
Related
- How to build a sourced timeline
A method for building a timeline from filings, laws and statistics: which date to record, how to write it, and how to cite the version you read.
- As of dates in statistics and official data
What reference periods, release dates, revisions and as of labels mean in official statistics and legal databases, with US, UK, Canada and India examples.
- Event date versus disclosure date
Why official records carry two dates, the day something happened and the day it was made public, with examples from the US, EU, Canada and Australia.