Template:ISOyear

Template documentation

Extracts year from calendar dates in ISO 8601 extended format (YYYY-MM-DD, e.g. "2024-04-02"). 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:

1. {{ISOyear|2009-09-09}} gives "2009"
2. {{ISOyear|2009-09-9}} gives "2009"
3. {{ISOyear|2009-9-09}} gives "2009"
4. {{ISOyear|0909-09-09}} gives "0909"
5. {{ISOyear|909-09-09}} gives "0909"
6. {{ISOyear|0099-09-09}} gives "0099"
7. {{ISOyear|099-09-09}} gives "0099"
8. {{ISOyear|99-09-09}} gives "0099"
9. {{ISOyear|+2009-09-09}} gives "2009"
10. {{ISOyear|-2009-09-09}} gives "-2009"
11. {{ISOyear|2009-13-09}} gives "2009"
12. {{ISOyear|2009-09-35}} gives "2009"
13. {{ISOyear|2009+09+09}} gives ""
14. {{ISOyear|2009/09/09}} gives ""
15. {{ISOyear|2009 09 09}} gives ""

YYYY-MM tests:

1. {{ISOyear|2009-09}} gives "2009"
2. {{ISOyear|2009-9}} gives "2009"
3. {{ISOyear|2009-13}} gives "2009"
4. {{ISOyear|0909-09}} gives "0909"
5. {{ISOyear|909-09}} gives "0909"
6. {{ISOyear|0100-09}} gives "0100"
7. {{ISOyear|0099-09}} gives "0099"
8. {{ISOyear|099-09}} gives "0099"
9. {{ISOyear|99-09}} gives "0099"
10. {{ISOyear|+2009-09}} gives "2009"
11. {{ISOyear|-2009-09}} gives "-2009"
12. {{ISOyear|2009/09}} gives ""
13. {{ISOyear|2009+09}} gives ""

YYYY tests:

1. {{ISOyear|2009}} gives "2009"
2. {{ISOyear|+2009}} gives "2009"
3. {{ISOyear|-2009}} gives "-2009"
4. {{ISOyear|0999}} gives "0999"
5. {{ISOyear|999}} gives "0999"
6. {{ISOyear|0099}} gives "0099"
7. {{ISOyear|099}} gives "0099"
8. {{ISOyear|99}} gives "0099"
9. {{ISOyear|9}} gives "0009"
10. {{ISOyear|0}} gives "0000"

0ther:

1. {{ISOyear}} gives ""
2. {{ISOyear|hello}} gives ""