Template:ISOyear/doc
This is a documentation subpage for Template:ISOyear. It contains usage information, categories, and other content that is not part of the original template page. |
Extracts year from calendar dates in ISO 8601 extended format (YYYY-MM-DD, e.g. "2024-04-15"). This template is very similar to {{#time: Y}} parser function , but accepts a year as input, even in cases where #time would interpret that as a time. In the case of wrong input template does not return anything.
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. |
Usage
{{ISOyear|1=}}
Parameters
Parameter name | Description | Default value | required or optional?
|
---|---|---|---|
parameter #1 (1) | date in ISO 8601 format. Supported formats: YYYY-MM-DD, YYYY-MM, YYYY. Other formats not officially supported but returning correct results include: single digit months and days and years without months or days can have any number of digits. Supported dates are any proleptic Gregorian calendar or Gregorian calendar dates between 1 January 0001 AD and 31 December 9999 AD. | empty | required |
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
See also
{{ISOdate}}
Localization
This template is not intended to be localized.
Testing
More tests can be found at Template:ISOyear/testcases.
YYYY-MM-DD tests:
{{ISOyear|2009-09-09}}
gives "2009"{{ISOyear|2009-09-9}}
gives "2009"{{ISOyear|2009-9-09}}
gives "2009"{{ISOyear|0909-09-09}}
gives "0909"{{ISOyear|909-09-09}}
gives "0909"{{ISOyear|0099-09-09}}
gives "0099"{{ISOyear|099-09-09}}
gives "0099"{{ISOyear|99-09-09}}
gives "0099"{{ISOyear|+2009-09-09}}
gives "2009"{{ISOyear|-2009-09-09}}
gives "-2009"{{ISOyear|2009-13-09}}
gives "2009"{{ISOyear|2009-09-35}}
gives "2009"{{ISOyear|2009+09+09}}
gives ""{{ISOyear|2009/09/09}}
gives ""{{ISOyear|2009 09 09}}
gives ""
YYYY-MM tests:
{{ISOyear|2009-09}}
gives "2009"{{ISOyear|2009-9}}
gives "2009"{{ISOyear|2009-13}}
gives "2009"{{ISOyear|0909-09}}
gives "0909"{{ISOyear|909-09}}
gives "0909"{{ISOyear|0100-09}}
gives "0100"{{ISOyear|0099-09}}
gives "0099"{{ISOyear|099-09}}
gives "0099"{{ISOyear|99-09}}
gives "0099"{{ISOyear|+2009-09}}
gives "2009"{{ISOyear|-2009-09}}
gives "-2009"{{ISOyear|2009/09}}
gives ""{{ISOyear|2009+09}}
gives ""
YYYY tests:
{{ISOyear|2009}}
gives "2009"{{ISOyear|+2009}}
gives "2009"{{ISOyear|-2009}}
gives "-2009"{{ISOyear|0999}}
gives "0999"{{ISOyear|999}}
gives "0999"{{ISOyear|0099}}
gives "0099"{{ISOyear|099}}
gives "0099"{{ISOyear|99}}
gives "0099"{{ISOyear|9}}
gives "0009"{{ISOyear|0}}
gives "0000"
0ther: