មើលកូដរបស់ ទំព័រគំរូ:ISOWEEKDAY/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
==Usage==
This template computes the ISO [[w:ISO week date|weekday number]] (1=Monday, ..., 7=Sunday) for a given Gregorian date (including proleptic years, down to at least 4800 BC, near the theoretical start of the old Roman calendar, and up to at least 5000 AD).

Alternative weekday number systems are:
*1=Monday, ..., 6=Saturday, 0=Sunday, used by variable <nowiki>{{CURRENTDOW}}</nowiki> 
**<nowiki>{{CURRENTDOW}}</nowiki> currently gives {{CURRENTDOW}}.
*0=Monday, ..., 5=Saturday, 6=Sunday, used by [[en:Template:WEEKDAY]] and [[fr:Modèle:WEEKDAY]]

The formula used to compute the weekday is purely cyclic, using only modular arithmetic operations and small integers (that can fit exactly within floating point variables), excluding all tests (with limited accepted value ranges). This allows all the parameters to be used linearly, including the month and day which are not required to be within 1 and the total numer of days in the indicated month and/or year.

So for computing the weekday number for a date which is ''N'' years, ''P'' months and ''Q'' days after another date known as ''y''|''m''|''d'', you can safely use this template with ''y''+''N''|''m''+''P''|''d''+''Q'', instead of having to determine the adjusted three elements of the target date with complex formulas (just to remain within the accepted limits of this function), as long as the target date remains within the Gregorian calendar (or proleptic Gregorian), i.e. after 4800BC, and covering all late Biblic dates, medieval, modern and contemporary dates, as well as future dates for several milleniums.

Syntax<nowiki>:</nowiki>
: <tt><nowiki>{{</nowiki>DOW|</tt>''year''<tt>|</tt>''month''<tt>|</tt>''day''<tt>}}</tt>
* The ''year'' must be astronomical (''year''=1 in [[1|1 AD]] (''[[Anno Domini]]''), ''year''=0 in 1 BC, ''year''=-1 in 2 BC).
* The ''month'' is between 1 and 12 from january to december.
* The ''day'' is normally between 1 and 31.

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

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

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

==See also==
* Template based upon [http://meta.wikimedia.org/wiki/Template:DOW MediaWiki:Template:DOW]
* [[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><!--
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANK YOU. -->
[[Category:Date-computing templates|{{PAGENAME}}]]
[[Category:ISO date templates|{{PAGENAME}}]]
[[no:Mal:ISOWEEKDAY]]
</includeonly>