Template:ISOdate/doc: Difference between revisions

Revision as of 13:28, 13 October 2012

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:ISOdate.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ кыргызча ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာမန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha / ўзбекча ∙ Tiếng Việt ∙ 中文 ∙ 中文（简体） ∙ 中文（繁體） ∙ 中文（臺灣） ∙ +/−

For a calendar date in ISO 8601 extended format in the form YYYY-MM-DD (e.g. "2026-08-22"), 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

Template parameters

Parameter	Description	Default	Status
`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
`2`	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	optional
`form`	allows to specify grammatical case for the month, for languages that use them. Possible cases: "form=gen" for genitive case "form=loc" for locative case (supported for Polish (pl) and Czech (cs) languages) "form=ins" for instrumental case (supported for Polish (pl) and Czech (cs) languages) leave blank for nominative case	empty	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

Example

{{ISOdate|2009-08-18}}

renders as:

18 August 2009

Localization

This template is not intended to be localized.

Example of where the template provides convenience

Template:Creator passes on the date of birth and death to e.g. Template:Creator/de and then to Template:Creator/layout. This is done through only two parameters birthdate and deathdate. The last-mentioned template calls this template ISODate to extract the 6 date components, and the time components, if any.

Test cases

{{ISOdate|2010-08-18 08:15:30Z}}: 18 August 2010, 08: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

@@ Line 8: / Line 8: @@
 |2def=language code of the user language
 |2stat=optional-
-|3=f
-|3d=format ("Y" for year-only output ["<nowiki>{{ISOdate|2008-08-06|f=Y}}</nowiki>" will result in the output "{{ISOdate|2008-08-06|f=Y}}"). Similar to {{tl|ISOyear}}.
-|3def=
-|3stat=optional-
 |4=form
@@ Line 97: / Line 92: @@
 |}
-{|
-|-
-|
-:<code><nowiki>{{ISOdate|f=Y|2010-08-18 08:15:30Z}}</nowiki></code>: {{ISOdate|f=Y|2010-08-18 08:15:30Z}}
-:<code><nowiki>{{ISOdate|f=Y|2010-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|2010-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|2010-08-18 08:15}}</nowiki></code>: {{ISOdate|f=Y|2010-08-18 08:15}}
-:<code><nowiki>{{ISOdate|f=Y|2010-08-18}}</nowiki></code>: {{ISOdate|f=Y|2010-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|2010-08}}</nowiki></code>: {{ISOdate|f=Y|2010-08}}
-:<code><nowiki>{{ISOdate|f=Y|2010}}</nowiki></code>: {{ISOdate|f=Y|2010}}
-:<code><nowiki>{{ISOdate|f=Y|1970-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|1970-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|1969-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|1969-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|1800-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|1800-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|999-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|999-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|119-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|119-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|99-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|99-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|19-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|19-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|9-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|9-08-18 08:15:30}}
-:<code><nowiki>{{ISOdate|f=Y|1-08-18 08:15:30}}</nowiki></code>: {{ISOdate|f=Y|1-08-18 08:15:30}}
-|
-:<code><nowiki>{{ISOdate|f=Y|1970-08-18}}</nowiki></code>: {{ISOdate|f=Y|1970-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|1969-08-18}}</nowiki></code>: {{ISOdate|f=Y|1969-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|1800-08-18}}</nowiki></code>: {{ISOdate|f=Y|1800-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|999-08-18}}</nowiki></code>: {{ISOdate|f=Y|999-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|119-08-18}}</nowiki></code>: {{ISOdate|f=Y|119-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|99-08-18}}</nowiki></code>: {{ISOdate|f=Y|99-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|19-08-18}}</nowiki></code>: {{ISOdate|f=Y|19-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|9-08-18}}</nowiki></code>: {{ISOdate|f=Y|9-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|1-08-18}}</nowiki></code>: {{ISOdate|f=Y|1-08-18}}
-:<code><nowiki>{{ISOdate|f=Y|1970-08}}</nowiki></code>: {{ISOdate|f=Y|1970-08}}
-:<code><nowiki>{{ISOdate|f=Y|1969-08}}</nowiki></code>: {{ISOdate|f=Y|1969-08}}
-:<code><nowiki>{{ISOdate|f=Y|1800-08}}</nowiki></code>: {{ISOdate|f=Y|1800-08}}
-:<code><nowiki>{{ISOdate|f=Y|999-08}}</nowiki></code>: {{ISOdate|f=Y|999-08}}
-:<code><nowiki>{{ISOdate|f=Y|119-08}}</nowiki></code>: {{ISOdate|f=Y|119-08}}
-:<code><nowiki>{{ISOdate|f=Y|99-08}}</nowiki></code>: {{ISOdate|f=Y|99-08}}
-|
-:<code><nowiki>{{ISOdate|f=Y|19-08}}</nowiki></code>: {{ISOdate|f=Y|19-08}}
-:<code><nowiki>{{ISOdate|f=Y|9-08}}</nowiki></code>: {{ISOdate|f=Y|9-08}}
-:<code><nowiki>{{ISOdate|f=Y|1-08}}</nowiki></code>: {{ISOdate|f=Y|1-08}}
-:<code><nowiki>{{ISOdate|f=Y|1970}}</nowiki></code>: {{ISOdate|f=Y|1970}}
-:<code><nowiki>{{ISOdate|f=Y|1969}}</nowiki></code>: {{ISOdate|f=Y|1969}}
-:<code><nowiki>{{ISOdate|f=Y|1800}}</nowiki></code>: {{ISOdate|f=Y|1800}}
-:<code><nowiki>{{ISOdate|f=Y|999}}</nowiki></code>: {{ISOdate|f=Y|999}}
-:<code><nowiki>{{ISOdate|f=Y|119}}</nowiki></code>: {{ISOdate|f=Y|119}}
-:<code><nowiki>{{ISOdate|f=Y|99}}</nowiki></code>: {{ISOdate|f=Y|99}}
-:<code><nowiki>{{ISOdate|f=Y|19}}</nowiki></code>: {{ISOdate|f=Y|19}}
-:<code><nowiki>{{ISOdate|f=Y|9}}</nowiki></code>: {{ISOdate|f=Y|9}}
-:<code><nowiki>{{ISOdate|f=Y|1}}</nowiki></code>: {{ISOdate|f=Y|1}}
-:<code><nowiki>{{ISOdate|f=Y|0}}</nowiki></code>: {{ISOdate|f=Y|0}}
-:<code><nowiki>{{ISOdate|f=Y|1567-02-29}}</nowiki></code>: {{ISOdate|f=Y|1567-02-29}}
-:<code><nowiki>{{ISOdate|f=Y|2000-02-29}}</nowiki></code>: {{ISOdate|f=Y|2000-02-29}}
-|}
 <includeonly>