View source for Template:ISOYEAR/doc

{{Template doc page}}

The '''ISOYEAR''' template computes the number of the [[ISO_week_date#Relation_with_the_Gregorian_calendar|ISO year]] for the date of the [[Gregorian calendar]] (or [[Proleptic Gregorian calendar|proleptic]]) in parameter. Any ISO year always includes an integer number, 52 or 53, of ISO weeks, each one starting on Monday and ending on Sunday.
The ISO year:
* starts at 0:00 of the Monday between 29 December of the previous Gregorian year and 4 January of the same Gregorian year (which is the Monday before the first Thursday of the same Gregorian year, and the Monday which is nearest in time to 1 January);
* finishes at 24:00 of the Sunday between 28 December of the same Gregorian year and 3 January of the next Gregorian year (which is the Sunday after the last Thursday of the same Gregorian year, and the Sunday which is nearest in time to 31 December).

Thus the first and last Thursday of the ISO year are also the first and last Thursday in the same Gregorian year.

The number of the ISO year always equals the number og the Gregorian (or proleptic) year for dates between 4 January and 28 December, and for every Thursday.

==Syntax<nowiki>:</nowiki>==
: <tt><nowiki>{{</nowiki>ISOYEAR|</tt>''year''<tt>|</tt>''month''<tt>|</tt>''day''<tt>}}</tt>
* The ''year'' must be astronomical (''année''=1 en [[1|1 ap. J.-C.]] (''[[Anno Domini]]''), ''année''=0 en 1 av. J.-C., ''année''=-1 en 2 av. J.-C.).
* The ''month'' is between 1 and 12 from January to December.
* The ''day'' is normally between 1 and 31 (but offsets are possible to compute other dates).

==Examples==
*{{evd|ISOYEAR|2005|12|31}}, and is eqv. with {{evd|ISOYEAR|2006|1|0}}
*{{evd|ISOYEAR|2006|1|1}}
*{{evd|ISOYEAR|2006|1|2}}

===Examples where the ISO year is three days into the next gregorian year ===
*{{evd|ISOYEAR|2009|12|31}}
*{{evd|ISOYEAR|2010|1|1}}
*{{evd|ISOYEAR|2010|1|2}}
*'''{{evd|ISOYEAR|2010|1|3}}'''
*{{evd|ISOYEAR|2010|1|4}}

===Examples where the ISO year is three days into the previous gregorian year ===
*{{evd|ISOYEAR|2008|12|28}}
*'''{{evd|ISOYEAR|2008|12|29}}'''
*{{evd|ISOYEAR|2008|12|30}}
*{{evd|ISOYEAR|2008|12|31}}
*{{evd|ISOYEAR|2009|1|1}}

=== More Examples<nowiki>:</nowiki> ===
* <tt><nowiki>{{ISOYEAR|1999|12|28}}</nowiki></tt> returns {{ISOYEAR|1999|12|28}}
* <tt><nowiki>{{ISOYEAR|1999|12|29}}</nowiki></tt> returns {{ISOYEAR|1999|12|29}}
* <tt><nowiki>{{ISOYEAR|1999|12|30}}</nowiki></tt> returns {{ISOYEAR|1999|12|30}}
* <tt><nowiki>{{ISOYEAR|1999|12|31}}</nowiki></tt> returns {{ISOYEAR|1999|12|31}}
* <tt><nowiki>{{ISOYEAR|2000|1|1}}</nowiki></tt> returns {{ISOYEAR|2000|1|1}}
* <tt><nowiki>{{ISOYEAR|2000|1|2}}</nowiki></tt> returns {{ISOYEAR|2000|1|2}}
* <tt><nowiki>{{ISOYEAR|2000|1|3}}</nowiki></tt> returns {{ISOYEAR|2000|1|3}}
* <tt><nowiki>{{ISOYEAR|2000|1|4}}</nowiki></tt> returns {{ISOYEAR|2000|1|4}}

* <tt><nowiki>{{ISOYEAR|2000|12|28}}</nowiki></tt> returns {{ISOYEAR|2000|12|28}}
* <tt><nowiki>{{ISOYEAR|2000|12|29}}</nowiki></tt> returns {{ISOYEAR|2000|12|29}}
* <tt><nowiki>{{ISOYEAR|2000|12|30}}</nowiki></tt> returns {{ISOYEAR|2000|12|30}}
* <tt><nowiki>{{ISOYEAR|2000|12|31}}</nowiki></tt> returns {{ISOYEAR|2000|12|31}}
* <tt><nowiki>{{ISOYEAR|2001|1|1}}</nowiki></tt> returns {{ISOYEAR|2001|1|1}}
* <tt><nowiki>{{ISOYEAR|2001|1|2}}</nowiki></tt> returns {{ISOYEAR|2001|1|2}}
* <tt><nowiki>{{ISOYEAR|2001|1|3}}</nowiki></tt> returns {{ISOYEAR|2001|1|3}}
* <tt><nowiki>{{ISOYEAR|2001|1|4}}</nowiki></tt> returns {{ISOYEAR|2001|1|4}}

* <tt><nowiki>{{ISOYEAR|2001|12|28}}</nowiki></tt> returns {{ISOYEAR|2001|12|28}}
* <tt><nowiki>{{ISOYEAR|2001|12|29}}</nowiki></tt> returns {{ISOYEAR|2001|12|29}}
* <tt><nowiki>{{ISOYEAR|2001|12|30}}</nowiki></tt> returns {{ISOYEAR|2001|12|30}}
* <tt><nowiki>{{ISOYEAR|2001|12|31}}</nowiki></tt> returns {{ISOYEAR|2001|12|31}}
* <tt><nowiki>{{ISOYEAR|2002|1|1}}</nowiki></tt> returns {{ISOYEAR|2002|1|1}}
* <tt><nowiki>{{ISOYEAR|2002|1|2}}</nowiki></tt> returns {{ISOYEAR|2002|1|2}}
* <tt><nowiki>{{ISOYEAR|2002|1|3}}</nowiki></tt> returns {{ISOYEAR|2002|1|3}}
* <tt><nowiki>{{ISOYEAR|2002|1|4}}</nowiki></tt> returns {{ISOYEAR|2002|1|4}}

* <tt><nowiki>{{ISOYEAR|2002|12|28}}</nowiki></tt> returns {{ISOYEAR|2002|12|28}}
* <tt><nowiki>{{ISOYEAR|2002|12|29}}</nowiki></tt> returns {{ISOYEAR|2002|12|29}}
* <tt><nowiki>{{ISOYEAR|2002|12|30}}</nowiki></tt> returns {{ISOYEAR|2002|12|30}}
* <tt><nowiki>{{ISOYEAR|2002|12|31}}</nowiki></tt> returns {{ISOYEAR|2002|12|31}}
* <tt><nowiki>{{ISOYEAR|2003|1|1}}</nowiki></tt> returns {{ISOYEAR|2003|1|1}}
* <tt><nowiki>{{ISOYEAR|2003|1|2}}</nowiki></tt> returns {{ISOYEAR|2003|1|2}}
* <tt><nowiki>{{ISOYEAR|2003|1|3}}</nowiki></tt> returns {{ISOYEAR|2003|1|3}}
* <tt><nowiki>{{ISOYEAR|2003|1|4}}</nowiki></tt> returns {{ISOYEAR|2003|1|4}}

* <tt><nowiki>{{ISOYEAR|2003|12|28}}</nowiki></tt> returns {{ISOYEAR|2003|12|28}}
* <tt><nowiki>{{ISOYEAR|2003|12|29}}</nowiki></tt> returns {{ISOYEAR|2003|12|29}}
* <tt><nowiki>{{ISOYEAR|2003|12|30}}</nowiki></tt> returns {{ISOYEAR|2003|12|30}}
* <tt><nowiki>{{ISOYEAR|2003|12|31}}</nowiki></tt> returns {{ISOYEAR|2003|12|31}}
* <tt><nowiki>{{ISOYEAR|2004|1|1}}</nowiki></tt> returns {{ISOYEAR|2004|1|1}}
* <tt><nowiki>{{ISOYEAR|2004|1|2}}</nowiki></tt> returns {{ISOYEAR|2004|1|2}}
* <tt><nowiki>{{ISOYEAR|2004|1|3}}</nowiki></tt> returns {{ISOYEAR|2004|1|3}}
* <tt><nowiki>{{ISOYEAR|2004|1|4}}</nowiki></tt> returns {{ISOYEAR|2004|1|4}}

* <tt><nowiki>{{ISOYEAR|2004|12|28}}</nowiki></tt> returns {{ISOYEAR|2004|12|28}}
* <tt><nowiki>{{ISOYEAR|2004|12|29}}</nowiki></tt> returns {{ISOYEAR|2004|12|29}}
* <tt><nowiki>{{ISOYEAR|2004|12|30}}</nowiki></tt> returns {{ISOYEAR|2004|12|30}}
* <tt><nowiki>{{ISOYEAR|2004|12|31}}</nowiki></tt> returns {{ISOYEAR|2004|12|31}}
* <tt><nowiki>{{ISOYEAR|2005|1|1}}</nowiki></tt> returns {{ISOYEAR|2005|1|1}}
* <tt><nowiki>{{ISOYEAR|2005|1|2}}</nowiki></tt> returns {{ISOYEAR|2005|1|2}}
* <tt><nowiki>{{ISOYEAR|2005|1|3}}</nowiki></tt> returns {{ISOYEAR|2005|1|3}}
* <tt><nowiki>{{ISOYEAR|2005|1|4}}</nowiki></tt> returns {{ISOYEAR|2005|1|4}}

* <tt><nowiki>{{ISOYEAR|2005|12|28}}</nowiki></tt> returns {{ISOYEAR|2005|12|28}}
* <tt><nowiki>{{ISOYEAR|2005|12|29}}</nowiki></tt> returns {{ISOYEAR|2005|12|29}}
* <tt><nowiki>{{ISOYEAR|2005|12|30}}</nowiki></tt> returns {{ISOYEAR|2005|12|30}}
* <tt><nowiki>{{ISOYEAR|2005|12|31}}</nowiki></tt> returns {{ISOYEAR|2005|12|31}}
* <tt><nowiki>{{ISOYEAR|2006|1|1}}</nowiki></tt> returns {{ISOYEAR|2006|1|1}}
* <tt><nowiki>{{ISOYEAR|2006|1|2}}</nowiki></tt> returns {{ISOYEAR|2006|1|2}}
* <tt><nowiki>{{ISOYEAR|2006|1|3}}</nowiki></tt> returns {{ISOYEAR|2006|1|3}}
* <tt><nowiki>{{ISOYEAR|2006|1|4}}</nowiki></tt> returns {{ISOYEAR|2006|1|4}}

* <tt><nowiki>{{ISOYEAR|2006|12|28}}</nowiki></tt> returns {{ISOYEAR|2006|12|28}}
* <tt><nowiki>{{ISOYEAR|2006|12|29}}</nowiki></tt> returns {{ISOYEAR|2006|12|29}}
* <tt><nowiki>{{ISOYEAR|2006|12|30}}</nowiki></tt> returns {{ISOYEAR|2006|12|30}}
* <tt><nowiki>{{ISOYEAR|2006|12|31}}</nowiki></tt> returns {{ISOYEAR|2006|12|31}}
* <tt><nowiki>{{ISOYEAR|2007|1|1}}</nowiki></tt> returns {{ISOYEAR|2007|1|1}}
* <tt><nowiki>{{ISOYEAR|2007|1|2}}</nowiki></tt> returns {{ISOYEAR|2007|1|2}}
* <tt><nowiki>{{ISOYEAR|2007|1|3}}</nowiki></tt> returns {{ISOYEAR|2007|1|3}}
* <tt><nowiki>{{ISOYEAR|2007|12|30}}</nowiki></tt> returns {{ISOYEAR|2007|13|30}}
* <tt><nowiki>{{ISOYEAR|2007|12|31}}</nowiki></tt> returns {{ISOYEAR|2007|12|31}}

; See also<nowiki>:</nowiki>
* [[Template:YEARCC]]
* [[Template:YEARYY]]
* [[Template:CENTURY]]
* [[Template:ISLEAPYEAR]]
* [[Template:MONTHDAYS]]
* [[Template:JULIANDAY]]
* [[Template:WEEKDAY]]
* [[Template:CURRENTISOYEAR]]

* [[Template:ISOWEEKDATE]] - {{evd|ISOWEEKDATE|2010|01|03}} The opposite function of {{tl|ISOWEEKDATE2YMD}}
:* [[Template:ISOYEAR]] - {{evd|ISOYEAR|2010|01|03}}
:* [[Template:ISOWEEK]] - {{evd|ISOWEEK|2010|01|03}}
:* [[Template:ISOWEEKDAY]] - {{evd|ISOWEEKDAY|2010|01|03}}
* [[Template:ISOWEEKDATE2YMD]] - {{evd|ISOWEEKDATE2YMD|2009|53|7}} The opposite function of {{tl|ISOWEEKDATE}}
:* [[Template:ISOWEEKDATE2Y]] - {{evd|ISOWEEKDATE2Y|2009|53|7}}
:* [[Template:ISOWEEKDATE2M]] - {{evd|ISOWEEKDATE2M|2009|53|7}}
:* [[Template:ISOWEEKDATE2D]] - {{evd|ISOWEEKDATE2D|2009|53|7}}

<includeonly>

<!-- INCLUDE CATEGORIES BELOW THIS LINE -->
[[Category:Date-computing templates|ISOYEAR]]
[[Category:ISO date templates|{{PAGENAME}}]]

<!-- INCLUDE INTERWIKIS BELOW THIS LINE -->
[[fr:Modèle:ISOYEAR]]
[[hsb:Předłoha:ISOYEAR]]
[[ko:틀:ISO 연]]
[[no:Mal:ISOYEAR]]
[[ru:Шаблон:ISOYEAR]]
[[stq:Foarloage:ISOYEAR]]
</includeonly>