Template:ISOdate/doc: Difference between revisions
Template page
More actions
m Reverted edits by Melanieclopez0214 (talk) to last revision by Jarekt |
Prefix language interwiki links with w: |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{Lua|Module:ISOdate}} | |||
{{TemplateBox | {{TemplateBox | ||
|1=1 | |1=1 | ||
|1aliases= date | |1aliases= date | ||
|1d=Any [[w:Proleptic Gregorian calendar|proleptic Gregorian calendar]] or [[w:Gregorian calendar|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 | |1d=Any [[w:Proleptic Gregorian calendar|proleptic Gregorian calendar]] or [[w:Gregorian calendar|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. | ||
|1label = date | |1label = date | ||
|1d-td = date | |1d-td = date | ||
| Line 20: | Line 21: | ||
|5=case | |5=case | ||
|5alias= form | |5alias= form | ||
|5d-en=allows to specify [[: | |5d-en=allows to specify [[:w:Grammatical case|grammatical case]] for the month for languages that use them. Possible cases: | ||
*leave blank for default case, which is usually [[: | * leave blank for default case, which is usually [[:w:Nominative case|nominative]] in most languages or [[:w:Genitive case|genitive case]], for a date given in isolation (out of a sentence). | ||
*"case=nom" for [[: | * "case=nom" for the [[:w:Nominative case|nominative case]] (for many languages with distinctive grammatical cases, for languages without case distinctions, this is the only existing form) | ||
*"case=gen" for [[: | * "case=gen" for the [[:w:Genitive case|genitive case]] (supported for languages with distinctive grammatical cases) | ||
*"case=loc" for [[: | * "case=loc" for the [[:w:Locative case|locative case]] (supported for languages: pl, cs, sl) | ||
*"case=ins" for [[: | * "case=ins" for the [[:w:Instrumental case|instrumental case]] (supported for languages: ru, pl, cs, sl) | ||
* "case=ptv" for the [[:w:Partitive case|partitive case]] (supported for language: fi) | |||
* "case=ine" for the [[:w:Inessive case|inessive case]] (supported for language: fi) | |||
* "case=ela" for the [[:w:Elative case|elative case]] (supported for language: fi) | |||
* "case=ill" for the [[:w:Illative case|illative case]] (supported for language: fi) | |||
|5label = case | |5label = case | ||
|5d-td = case | |5d-td = case | ||
| Line 32: | Line 36: | ||
|6=class | |6=class | ||
|6d-en=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 [[w:HCalendar|hCalendar]]). See [[Commons:Microformats Project|the microformats project]]. "class=" will remove all metadata. | |6d-en=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 [[w:HCalendar|hCalendar]]). See [[Commons:Microformats Project|the microformats project]]. "class=-" or "class=" will remove all metadata. | ||
|6label = class | |6label = class | ||
|6d-td = class | |6d-td = class | ||
| Line 50: | Line 54: | ||
|name=ISOdate | |name=ISOdate | ||
|desc=For a [[: | |desc=For a [[:w:ISO 8601#Calendar dates|calendar date in ISO 8601]] ''extended format'' in the form YYYY-MM-DD (e.g. "{{#time: Y-m-d }}"), with or without time, this template extracts the year, month, day and time, and calls {{tl|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 {{tl|date}} eventually needs the date components separately. | ||
This template overcomes some flaws of the automatic conversion by <nowiki>{{#time: }}</nowiki> for non-full dates (e.g. "77-09" for September 77 AD, which would throw an error with <nowiki>{{#time: }}</nowiki>). | This template overcomes some flaws of the automatic conversion by <nowiki>{{#time: }}</nowiki> for non-full dates (e.g. "77-09" for September 77 AD, which would throw an error with <nowiki>{{#time: }}</nowiki>). | ||
| Line 61: | Line 65: | ||
|i18n-desc= | |i18n-desc= | ||
|seealso={{tl|date}}, {{tl|other date}}, {{tl|ISOyear}} | |seealso={{tl|date}}, {{tl|other date}}, {{tl|ISOyear}} | ||
|relieson = [[Module: | |relieson = [[Module:DateI18n]] | ||
|setscats= | |setscats= | ||
|lines=one | |lines=one | ||
| Line 72: | Line 76: | ||
|- | |- | ||
| | | | ||
:<code><nowiki>{{ISOdate|2010-11-01}}</nowiki></code>: {{ISOdate|2010-11-01}} | |||
:<code><nowiki>{{ISOdate|2010-08-18 18:15:30Z}}</nowiki></code>: {{ISOdate|2010-08-18 18:15:30Z}} | :<code><nowiki>{{ISOdate|2010-08-18 18:15:30Z}}</nowiki></code>: {{ISOdate|2010-08-18 18:15:30Z}} | ||
:<code><nowiki>{{ISOdate|2010-08-18 08:15:30}}</nowiki></code>: {{ISOdate|2010-08-18 08:15:30}} | :<code><nowiki>{{ISOdate|2010-08-18 08:15:30}}</nowiki></code>: {{ISOdate|2010-08-18 08:15:30}} | ||
Latest revision as of 09:16, 12 August 2026
| Uses Lua: |
For a calendar date in ISO 8601 extended format in the form YYYY-MM-DD (e.g. "2026-08-21"), 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 | |
|---|---|---|---|---|
1date | 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 |
lang2 | 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:
| 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_yeartrim year | trim year | Should years smaller than 1000 be padded with zeros to the length of 4 digits or trimmed. Options:
| 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|2026-08-21}}
renders as:
21 August 2026
See also
Localization
This template is not intended to be localized.
Test cases
|
|