ISO 8601

(Difference between revisions)

Jump to: navigation, search
m (entry-title, updated microformats section, responded to issues)
Current revision (11:28, 3 October 2013) (view source)
(ISO 8601 implementations in programming libraries: adding Python impl)
 
(8 intermediate revisions not shown.)
Line 1: Line 1:
<entry-title>ISO 8601</entry-title>
<entry-title>ISO 8601</entry-title>
-
The '''International Standards Organisation''''s standard, number '''8601''' is an international standard for date and time representations. It is used for all date-time representations in microformats, as well as a number of other formats (XML, XML Schema Datatypes, RDF, Atom).
+
The '''International Standards Organisation''''s standard, number '''8601''' is an international standard for date and time representations. It is used for all date-time representations in microformats, as well as a number of other formats ([[HTML5]] <code>&lt;time&gt;</code> element &amp; <code>datetime</code> attribute, XML Schema Datatypes, RDF, Atom).
<div style="float: right">https://sslimgs.xkcd.com/comics/iso_8601.png
<div style="float: right">https://sslimgs.xkcd.com/comics/iso_8601.png
Line 25: Line 25:
__TOC__
__TOC__
 +
== HTML5 ==
 +
[[HTML5]] uses both a subset of ISO 8601 for dates, times, durations for the <code>&lt;time&gt;</code> element, as well as an extended (and more human friendly) duration format.
 +
==<nowiki>RFC 3339</nowiki>==
==<nowiki>RFC 3339</nowiki>==
Line 37: Line 40:
* Ruby 1.9 implements an iso8601 method in the Date STDLIB but it does not handle ordinal dates.
* Ruby 1.9 implements an iso8601 method in the Date STDLIB but it does not handle ordinal dates.
* Glenn Jones' [https://github.com/glennjones/microformat-node microformat-node] parser includes isodate.js, a Node.js implementation of (some of) ISO 8601.
* Glenn Jones' [https://github.com/glennjones/microformat-node microformat-node] parser includes isodate.js, a Node.js implementation of (some of) ISO 8601.
 +
* Python: [https://pypi.python.org/pypi/iso8601 iso8601]
{{ToDo}} document more implementations.
{{ToDo}} document more implementations.
 +
 +
== FAQ ==
 +
=== Why hyphens in dates ===
 +
Q: Must I use the hyphens?[https://twitter.com/edburns/status/368063860835897344]
 +
 +
A: You <em>should</em> always use hyphens in ISO 8601 dates because that makes them more readable, and thus more human friendly.
 +
 +
Also, using hyphens helps clearly distinguish different uses for different granularities of dates, e.g.:
 +
* 2013-08-19 - just the day
 +
* 2013-08 - the whole month
 +
* 2013 - the entire year
==Issues==
==Issues==
-
* How should dates before the common era be marked up? [[User:AndyMabbett|Andy Mabbett]]
+
None currently.
-
** What are the use-cases? Link to *-examples page? - [[User:Tantek|Tantek]]
+
 
-
* If a web page is created or edited by a non-technical human, it is unfriendly to expect them to work in ISO date format. [[User:CharlesBelov|Charles Belov]]
+
Resolved issues: [[iso-8601-issues-resolved]].
-
** ISO dates are more readable/usable by people globally than any one locale-specific format, thus it is more friendly globally to use and ask humans to edit ISO 8601 dates than asking them to try to read/write all the odd and quirky locale-specific formats. - [[User:Tantek|Tantek]]
+
==See also==
==See also==

Current revision


The International Standards Organisation's standard, number 8601 is an international standard for date and time representations. It is used for all date-time representations in microformats, as well as a number of other formats (HTML5 <time> element & datetime attribute, XML Schema Datatypes, RDF, Atom).

iso_8601.png

Image: XKCD

In addition, ISO 8601 dates in particular are the most globally unambiguously human readable/writeable date format and thus should always be used on the (world wide) web.

Overview

The following are good prose overviews of ISO 8601:

Microformats

microformats in general use a subset of ISO8601 - preferring uses which are more human readable (requiring hyphens in dates, and colons in times).

All date-time properties in microformats use ISO8601 values. E.g.

Contents

HTML5

HTML5 uses both a subset of ISO 8601 for dates, times, durations for the <time> element, as well as an extended (and more human friendly) duration format.

RFC 3339

RFC 3339 defines a profile of ISO 8601 for the use in Internet protocols and standards.

ISO 8601 implementations in programming libraries

to do! document more implementations.

FAQ

Why hyphens in dates

Q: Must I use the hyphens?[1]

A: You should always use hyphens in ISO 8601 dates because that makes them more readable, and thus more human friendly.

Also, using hyphens helps clearly distinguish different uses for different granularities of dates, e.g.:

Issues

None currently.

Resolved issues: iso-8601-issues-resolved.

See also

Related pages

ISO 8601 was last modified: Thursday, October 3rd, 2013

Views