Template:ISOyear

Documentation

This documentation is transcluded from Template:ISOyear/doc. (edit | history)

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

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
debug	Turns on debugging. Use "debug=1" for template to return additional marking useful in debugging of the template.	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

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 ""
10. {{ISOyear|-2009-09-09}} gives ""
11. {{ISOyear|2009-13-09}} gives ""
12. {{ISOyear|2009-09-35}} gives ""
13. {{ISOyear|2009+09+09}} gives ""
14. {{ISOyear|2009/09/09}} gives "2009"
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 ""
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 ""
11. {{ISOyear|-2009-09}} gives ""
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 ""