قالب:ISOyear/doc

Extracts year from calendar dates in ISO 8601 extended format (YYYY-MM-DD, e.g. "2024-11-22"). 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 ""
  3. {{ISOyear|-2009}} gives ""
  4. {{ISOyear|0999}} gives "0999"
  5. {{ISOyear|999}} gives ""
  6. {{ISOyear|0099}} gives "0099"
  7. {{ISOyear|099}} gives ""
  8. {{ISOyear|99}} gives ""
  9. {{ISOyear|9}} gives ""
  10. {{ISOyear|0}} gives ""

0ther:

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