ISO 8601 Date Formatting
The information presented here is a quick reference adapted from Wikipedia’s ISO 8601 article to describe the formats used in this site.
Dates and Times
Dates are presented in YYYY-MM-DD format.
Times are presented in 24-hour hh:mm format. The specification includes a leading T character, but it is omitted here. The specification also permits the omission of minutes if a time occurs at the “top of the hour,” but doing so can lead to confusion; so minutes are included with all formatted times.
When combined, the date and time elements are separated by a space to improve readability, i.e., YYYY-MM-DD hh:mm, rather than the specified T character.
Timezones
Times are typically represented in local time, which for this site is Central Time (UTC-06:00, or UTC-05:00 during Daylight Savings Time).
However, if specific time zone information is important for some reason, then times will likely include the offset suffix, e.g., -06:00, or be given in UTC with a Z suffix.
For example, 2023-03-05 12:00 can be considered equivalent to 2023-03-05 12:00-06:00 and 2023-03-05 18:00Z.
The use of a - character for this information necessitates a seemingly odd format for encoding intervals.
Weekdays
Weekdays are not mentioned in the official ISO 8601 specification outside of using a “week-numbering year,” but if they are included as part of the content in this site, they will be either:
-
mentioned before the date, e.g.,
Sunday, 2023-03-05 12:00; or -
abbreviated after the date, e.g.,
2023-03-05 (U) 12:00.
The abbreviations that might be used:
| Weekday | 1-letter | 2-letter | 3-letter |
|---|---|---|---|
| Sunday | U |
Su |
Sun |
| Monday | M |
Mo |
Mon |
| Tuesday | T |
Tu |
Tue |
| Wednesday | W |
We |
Wed |
| Thursday | R |
Th |
Thu |
| Friday | F |
Fr |
Fri |
| Saturday | S |
Sa |
Sat |
Durations
Durations are not commonly used in the content of this site, but they are included here for completeness.
This is probably best explained and understood using several examples:
- 3 years:
P3Y - 1 month:
P1M - 3 years, 1 month:
P3Y1M - 30 minutes:
PT30M - 3 years, 1 month, 30 minutes:
P3Y1MT30M - 24 hours:
PT24H - 1 day:
P1D - 6 weeks:
P6W - 10 seconds:
PT10S - 1 year, 2 months, 3 weeks, 4 days, 5 hours, 6 minutes, 7 seconds:
P1Y2M3W4DT5H6M7S
In general, P<date>T<time>, where <date> and <time> contain “atoms” according to the specified time unit with a preceding count. Atoms are ordered with the largest unit first, and atoms without any value are omitted.
<date>atoms are:Yfor yearsMfor monthsWfor weeksDfor days
<time>atoms are:Hfor hoursMfor minutesSfor seconds
Intervals
Intervals represent ranges of that are anchored to a specific date and/or time (either at the start, at the end, or both). If either the start or the end is not a date/time, then a duration is used instead.
The specification defines intervals using the following format options:
<start>/<end>- anchored with date/time on both sides,<start>/<duration>- anchored with a start date/time and duration following, or<duration>/<end>- anchored with an end date/time and duration preceding.
The first format is almost exclusively used in the content on this site. This format permits the omission of higher-ordered elements (i.e., those with larger units) that are identical between the start and end. For example:
2023-03-05 12:00/2023-03-05 16:00can be shortened to2023-03-05 12:00/16:002023-03-05/2023-03-07can be shortened to2023-03-05/07