Template:ISOdate/doc

For a calendar date in ISO 8601 extended format in the form YYYY-MM-DD (e.g. "2024-04-28"), 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: }}).

This template has been copied from Commons as a guide for future development for Commons.
Not all functionality and not all languages supported by the original template may be available.
For further information and discussion see the talk page.

Deutsch | English | español | français | 日本語 | português | svenska | +/−

Usage

{{ISOdate|1=}}

Parameters

Parameter name Description Default value required or optional?

parameter #1 (1) 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 a dash and a 2-digit month number; optionally this is followed by a dash and a 2-digit day number; optionally this is followed by the time. empty required
lang language code of the user language ({{int:Lang}}) optional
case empty optional
class dtstart optional
trim_year 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:Date

Example

{{ISOdate|2024-04-28}}

renders as:

See also

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

Localization

This template is not intended to be localized.

Test cases

{{ISOdate|2010-08-18 18:15:30Z}}:
{{ISOdate|2010-08-18 08:15:30}}:
{{ISOdate|2010-08-18 08:15}}:
{{ISOdate|2010-08-18}}:
{{ISOdate|2010-08}}:
{{ISOdate|2010}}:
{{ISOdate|1970-08-18 08:15:30}}:
{{ISOdate|1969-08-18 08:15:30}}:
{{ISOdate|1800-08-18 08:15:30}}:
{{ISOdate|999-08-18 08:15:30}}: 08:15:30
{{ISOdate|119-08-18 08:15:30}}: 08:15:30
{{ISOdate|99-08-18 08:15:30}}: 08:15:30
{{ISOdate|19-08-18 08:15:30}}: 08:15:30
{{ISOdate|9-08-18 08:15:30}}: 08:15:30
{{ISOdate|1-08-18 08:15:30}}: 08:15:30
{{ISOdate|1970-08-18}}:
{{ISOdate|1969-08-18}}:
{{ISOdate|1800-08-18}}:
{{ISOdate|999-08-18}}:
{{ISOdate|119-08-18}}:
{{ISOdate|99-08-18}}:
{{ISOdate|19-08-18}}:
{{ISOdate|9-08-18}}:
{{ISOdate|1-08-18}}:
{{ISOdate|1970-08}}:
{{ISOdate|1969-08}}:
{{ISOdate|1800-08}}:
{{ISOdate|999-08}}:
{{ISOdate|119-08}}:
{{ISOdate|99-08}}:
{{ISOdate|19-08}}:
{{ISOdate|9-08}}:
{{ISOdate|1-08}}:
{{ISOdate|1970}}:
{{ISOdate|1969}}:
{{ISOdate|1800}}:
{{ISOdate|999}}:
{{ISOdate|119}}:
{{ISOdate|99}}:
{{ISOdate|19}}:
{{ISOdate|9}}:
{{ISOdate|1}}:
{{ISOdate|0}}:
{{ISOdate|1567-02-29}}:
{{ISOdate|2000-02-29}}: