Read a complete timestamp
01A timestamp identifies an instant. RFC 3339 defines a restricted ISO 8601 date/time format using the Gregorian calendar and an explicit relation to UTC, Coordinated Universal Time.
The base grammar also permits 1985-04-12t23:20:50.52z. Uppercase T and Z are the recommended generated spelling; lowercase does not automatically make a base-profile timestamp invalid.
Source for this drawing: RFC 3339 · Read RFC section 5.6 ↗
New to this? Start hereA quick picture + helpful background
A message needs an address.
Think of a packet as a small addressed envelope. Devices pass it onward; transport protocols decide what delivery promises an application gets.
Start with this guide; no earlier guide is needed for the overview.
These pictures are analogies to help you learn. The linked RFC explains the actual rules.
Terms in this drawing
Related RFCs and changes
“Updates” changes part of an earlier RFC. “Obsoletes” replaces it. This list shows selected related documents.
Keep the date, time and offset together.
- A full timestamp uses four-digit year-month-day, T, hour:minute:second, an optional decimal fraction, and Z or a signed hour:minute offset. Internet protocols MUST generate four-digit years.
- The fractional part is a dot followed by one or more digits. Date and clock separators and seconds are present in the §5.6 date-time grammar. This is a profile, not every ISO 8601 representation.
- T and Z may be lowercase in the base grammar. Generators SHOULD use uppercase; a specification using case-sensitive environments MAY require uppercase. New Internet protocols SHOULD use this profile.
The published example 1985-04-12T23:20:50.52Z identifies an instant with 52 hundredths of a second. The main profile is §5.6, not the wider collected ISO grammar in Appendix A. Its note permits applications to specify another date/time separator for readability, while held erratum5783 records ambiguity; this guide’s literal examples use T/t and do not silently declare every space-separated string part of the base ABNF. Date-only values may be used by other application contracts, but are not complete date-time timestamps.
Read the RFC section ↗