Template:ISOdate

Note: This template is used on a lot of pages. In order not to put too much load on the servers, edits should be kept to a bare minimum. Please discuss proposed changes on the talk page first. Afterwards, changes can initially be done at and tested with Template:ISOdate/sandbox. Editing a template causes all pages that use the template to be re-rendered. If the template is used often, this can put a lot of load on the servers since it fills up the job queue. Keep in mind that templates that are used on file description pages also show up on other wikis. This page has been protected from editing to prevent vandalism. Only administrators can edit it. Get their attention by placing {{Edit protected}} at the talk page.

This template has been protected from editing to prevent vandalism. Please discuss changes on the talk page or request unprotection.

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:ISOdate/doc.

For a calendar date in ISO 8601 extended format in the form YYYY-MM-DD (e.g. "2024-11-05"), with or without time, this template extracts the year, month, day and time, and calls {{Date}} with the year, month and day found to display the date in localised format, with the time, if specified, appended. It provides the convenience of passing on a date (or even a date and a time) from one template to another as a single parameter, even though {{Date}} eventually needs the date components separately.

This template overcomes some flaws of the automatic conversion by {{#time: }} for non-full dates (e.g. "77-09" for September 77 AD, which would throw an error with {{#time: }}).

Usage

{{ISOdate |1= }}

Template parameters

Parameter	Description		Default	Status
1 date	date	Any proleptic Gregorian calendar or Gregorian calendar date between 1 January 1 AD and 31 December 9999 AD. Dates BC are not yet supported. Also incomplete dates are allowed: just the year or the year and the month. A year has to be written in full, without leading zeros. Optionally it is followed by hyphen-minus (-) and a 2-digit month number; optionally this is followed by hyphen-minus and a 2-digit day number; optionally this is followed by the time.	empty	required
lang 2	language	language code (only needs to be provided if the language shall be fixed and independent from the user's preferences)	language code of the user language ({{int:Lang}})	optional
case	case	allows to specify grammatical case for the month for languages that use them. Possible cases: leave blank for default case, which is usually nominative in most languages or genitive case, for a date given in isolation (out of a sentence). "case=nom" for the nominative case (for many languages with distinctive grammatical cases, for languages without case distinctions, this is the only existing form) "case=gen" for the genitive case (supported for languages with distinctive grammatical cases) "case=loc" for the locative case (supported for languages: pl, cs, sl) "case=ins" for the instrumental case (supported for languages: ru, pl, cs, sl) "case=ptv" for the partitive case (supported for language: fi) "case=ine" for the inessive case (supported for language: fi) "case=ela" for the elative case (supported for language: fi) "case=ill" for the illative case (supported for language: fi)	empty	optional
class	class	allows to set the html class of the time node where the date is included. This is useful for microformats. The default value is, for legacy reasons, "dtstart" (used by hCalendar). See the microformats project. "class=-" or "class=" will remove all metadata.	dtstart	optional
trim_year trim year	trim year	Should years smaller than 1000 be padded with zeros to the length of 4 digits or trimmed. Options: 1, yes, true - for always trimming 0, no, false - for always padding xx-yy - where xx is a minimum trimmed year and yy is the maximum trimmed year, for conditional trimming which depends on the year range.	100-999	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

Relies on:
Module:DateI18n

Example

{{ISOdate|2024-11-5}}

renders as:

5 November 2024

See also

{{Date}}, {{Other date}}, {{ISOyear}}

Localization

This template is not intended to be localized.

Test cases

{{ISOdate|2010-08-18 18:15:30Z}}: 18 August 2010, 18:15:30 {{ISOdate|2010-08-18 08:15:30}}: 18 August 2010, 08:15:30 {{ISOdate|2010-08-18 08:15}}: 18 August 2010, 08:15 {{ISOdate|2010-08-18}}: 18 August 2010 {{ISOdate|2010-08}}: August 2010 {{ISOdate|2010}}: 2010 {{ISOdate|1970-08-18 08:15:30}}: 18 August 1970, 08:15:30 {{ISOdate|1969-08-18 08:15:30}}: 18 August 1969, 08:15:30 {{ISOdate|1800-08-18 08:15:30}}: 18 August 1800, 08:15:30 {{ISOdate|999-08-18 08:15:30}}: 18 August 999 08:15:30 {{ISOdate|119-08-18 08:15:30}}: 18 August 119 08:15:30 {{ISOdate|99-08-18 08:15:30}}: 18 August 0099 08:15:30 {{ISOdate|19-08-18 08:15:30}}: 18 August 0019 08:15:30 {{ISOdate|9-08-18 08:15:30}}: 18 August 0009 08:15:30 {{ISOdate|1-08-18 08:15:30}}: 18 August 0001 08:15:30 {{ISOdate|1970-08-18}}: 18 August 1970 {{ISOdate|1969-08-18}}: 18 August 1969 {{ISOdate|1800-08-18}}: 18 August 1800 {{ISOdate|999-08-18}}: 18 August 999 {{ISOdate|119-08-18}}: 18 August 119 {{ISOdate|99-08-18}}: 18 August 0099 {{ISOdate|19-08-18}}: 18 August 0019

{{ISOdate|9-08-18}}: 18 August 0009 {{ISOdate|1-08-18}}: 18 August 0001 {{ISOdate|1970-08}}: August 1970 {{ISOdate|1969-08}}: August 1969 {{ISOdate|1800-08}}: August 1800 {{ISOdate|999-08}}: August 999 {{ISOdate|119-08}}: August 119 {{ISOdate|99-08}}: August 0099 {{ISOdate|19-08}}: August 0019 {{ISOdate|9-08}}: August 0009 {{ISOdate|1-08}}: August 0001 {{ISOdate|1970}}: 1970 {{ISOdate|1969}}: 1969 {{ISOdate|1800}}: 1800 {{ISOdate|999}}: 999 {{ISOdate|119}}: 119 {{ISOdate|99}}: 0099 {{ISOdate|19}}: 0019 {{ISOdate|9}}: 0009 {{ISOdate|1}}: 0001 {{ISOdate|0}}: 0000 {{ISOdate|1567-02-29}}: 1 March 1567 {{ISOdate|2000-02-29}}: 29 February 2000