Template:ISO date

From MattWiki
Jump to navigation Jump to search


Documentation icon Template documentation[view] [edit] [history] [purge]

This template converts dates to YYYY-MM-DD or YYYY-MM or YYYY as appropriate - see below for restrictions on input formats accepted.


This template only converts dates formatted in one of the formats below to an ISO date

The template accepts one parameter - which must be unnamed. For example:

  • {{ISO date|15 January 2001}} returns 2001-01-15
  • {{ISO date|March 2003}} returns 2003-03

The date parameter must be in one of the following formats:

  • 15 January 2001
  • 15 Jan 2001
  • January 15, 2001
  • Jan 15, 2001
  • 15-01-2001
  • January 2001
  • Jan 2001
  • 2001

Formats for which it can not work because #time returns an error:

  • 01-15-2001
  • 1/2001

Use in microformats

This template also returns the date, hidden by CSS, in the ISO 8601 format needed by one or more of the following microformats:

usually, but not always, within infobox or similar templates, or tables.

Its use in hCard is for organizations, venues and similar; use {{Birth date}} or {{Birth date and age}} for people.

Similarly, {{End date}} returns the date as hCalendar's (class="dtend").

See the microformats project for further details.


This template has no provision to deal with a date in a non-Gregorian calendar. Also, ISO 8601 requires mutual agreement among those exchanging information before using years outside the range 1583–9999 CE. Therefore, use of this template for non-Gregorian dates or dates outside that range constitutes a false claim of conformance to the ISO 8601 standard.

Any editor encountering such usage should change the date to plain text with no template; or if not confident in doing so, raise the matter on this template's talk page.

See also