Дидани манбаъи Шаблон:Weekday in month/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
== Usage ==

;Code
Note that the order of the input can be reversed.  The following give the same output.
:<code><nowiki>{{Weekday in month|</nowiki></code>''y''<code>|</code>''m''<code>|</code>''w''<code>|</code>''n''<code>}}</code>
:<code><nowiki>{{Weekday in month|</nowiki></code>''n''<code>|</code>''w''<code>|</code>''m''<code>|</code>''y''<code>}}</code>

Note that the year is optional.  The following give the ''n''th ''w''-day of month ''m'' this year.
:<code><nowiki>{{Weekday in month||</nowiki></code>''m''<code>|</code>''w''<code>|</code>''n''<code>}}</code>
:<code><nowiki>{{Weekday in month|</nowiki></code>''n''<code>|</code>''w''<code>|</code>''m''<code>}}</code>

;Parameters
{|class=wikitable
|-
!style="vertical-align:top;"| ''y'' 
| style="vertical-align:top;" | year
|numeric format, certain words, blank
*Integers from 1000 to 9999 are accepted.
*<code>last year</code> and <code>next year</code> are accepted.
*The year is optional (defaults to the current year).
|-
!style="vertical-align:top;"| ''m'' 
| style="vertical-align:top;" | month
|numeric format, spelt out in full or abbreviated
*For numeric input a leading zero is optional.
*Three-letter abbreviations are accepted (e.g. <code>Jan</code>, <code>Feb</code>, etc.)
|-
!style="vertical-align:top;"| ''w'' 
| style="vertical-align:top;" | weekday 
|numeric format, spelt out in full or abbreviated
*Three-letter abbreviations are accepted (e.g. <code>Sun</code>, <code>Mon</code>, etc.)
*The weekday numbering follows ISO practice (Sunday → 0, Monday → 1, ... Saturday → 6).
|-
!style="vertical-align:top;"| ''n'' 
| style="vertical-align:top;" | count
|numeric format, spelt out in full or abbreviated
*Positive integers give the ''n''th Sunday/Monday ... Saturday of the month.
*Negative integers give the ''n''th last Sunday/Monday ... Saturday of the month.
*Words are accepted (e.g. <code>first</code>, <code>last</code>, etc.)
*Abbreviations are accepted (e.g. <code>1st</code>, <code>2nd</code>, etc.)
|}
 
;Examples
{|
|-
|width=350|
*for the first Sunday of January 2000
**''n'' = <code>first</code>, <code>1st</code> or <code>1</code>
**''w'' = <code>Sunday</code>, <code>Sun</code> or <code>0</code>
**''m'' = <code>January</code>, <code>Jan</code> or <code>1</code>
**''y'' = <code>2000</code>
*for the first Monday of February 2006
**''n'' = <code>first</code>, <code>1st</code> or <code>1</code>
**''w'' = <code>Monday</code>, <code>Mon</code> or <code>1</code>
**''m'' = <code>February</code>, <code>Feb</code> or <code>2</code>
**''y'' = <code>2006</code>
*for the first Tuesday of March 2010
**''n'' = <code>first</code>, <code>1st</code> or <code>1</code>
**''w'' = <code>Tuesday</code>, <code>Tue</code> or <code>2</code>
**''m'' = <code>March</code>, <code>Mar</code> or <code>3</code>
**''y'' = <code>2010</code>
*for the second Tuesday of April 2012
**''n'' = <code>second</code>, <code>2nd</code> or <code>2</code>
**''w'' = <code>Tuesday</code>, <code>Tue</code> or <code>2</code>
**''m'' = <code>April</code>, <code>Apr</code> or <code>4</code>
**''y'' = <code>2012</code>
|width=500|
*for the second Tuesday of May 2020
**''n'' = <code>second</code>, <code>2nd</code> or <code>2</code>
**''w'' = <code>Tuesday</code>, <code>Tue</code> or <code>2</code>
**''m'' = <code>May</code> or <code>5</code>
**''y'' = <code>2020</code>
*for the second Wednesday of June 2100
**''n'' = <code>second</code>, <code>2nd</code> or <code>2</code>
**''w'' = <code>Wednesday</code>, <code>Wed</code> or <code>3</code>
**''m'' = <code>June</code>, <code>Jun</code> or <code>6</code>
**''y'' = <code>2100</code>
*for the third Wednesday of July this year
**''n'' = <code>third</code>, <code>3rd</code> or <code>3</code>
**''w'' = <code>Wednesday</code>, <code>Wed</code> or <code>3</code>
**''m'' = <code>July</code>, <code>Jul</code> or <code>7</code>
**''y'' = <code><nowiki>{{#time:Y}}</nowiki></code>, <code><nowiki>{{CURRENTYEAR}}</nowiki></code> or leave it blank
*for the third Thursday of August this year
**''n'' = <code>third</code>, <code>3rd</code> or <code>3</code>
**''w'' = <code>Thursday</code>, <code>Thu</code> or <code>4</code>
**''m'' = <code>August</code>, <code>Aug</code> or <code>8</code>
**''y'' = <code><nowiki>{{#time:Y}}</nowiki></code>, <code><nowiki>{{CURRENTYEAR}}</nowiki></code> or leave it blank
|width=600|
*for the last Thursday of September last year
**''n'' = <code>last</code> or <code>-1</code>
**''w'' = <code>Thursday</code>, <code>Thu</code> or <code>4</code>
**''m'' = <code>September</code>, <code>Sep</code> or <code>9</code>
**''y'' = <code><nowiki>{{#time:Y|last year}}</nowiki></code>, <code><nowiki>{{LASTYEAR}}</nowiki></code> or <code>last year</code>
*for the last Friday of October last year
**''n'' = <code>last</code> or <code>-1</code>
**''w'' = <code>Friday</code>, <code>Fri</code> or <code>5</code>
**''m'' = <code>October</code>, <code>Oct</code> or <code>10</code>
**''y'' = <code><nowiki>{{#time:Y|last year}}</nowiki></code>, <code><nowiki>{{LASTYEAR}}</nowiki></code> or <code>last year</code>
*for the second last Friday of November next year
**''n'' = <code>second last</code>, <code>2nd last</code> or <code>-2</code>
**''w'' = <code>Friday</code>, <code>Fri</code> or <code>5</code>
**''m'' = <code>November</code>, <code>Nov</code> or <code>11</code>
**''y'' = <code><nowiki>{{#time:Y|next year}}</nowiki></code>, <code><nowiki>{{NEXTYEAR}}</nowiki></code> or <code>next year</code>
*for the second last Saturday of December next year
**''n'' = <code>second last</code>, <code>2nd last</code> or <code>-2</code>
**''w'' = <code>Saturday</code>, <code>Sat</code> or <code>6</code>
**''m'' = <code>December</code>, <code>Dec</code> or <code>12</code>
**''y'' = <code><nowiki>{{#time:Y|next year}}</nowiki></code>, <code><nowiki>{{NEXTYEAR}}</nowiki></code> or <code>next year</code>
|}

==Calculation==
The template then gives ''j'', the day of the month, as calculated by the following formulae.

:''j'' = 7×''n'' − 6 + (''w'' − ''w<sub>1</sub>'') mod 7 (for positive ''n'')

:''j'' = ''t'' + 7×(''n'' + 1) − (''w<sub>t</sub>'' − ''w'') mod 7 (for negative ''n'')

Where ''t'' is the last day of the month, ''w<sub>t</sub>'' is the ISO weekday number of the last day of the month, ''w<sub>1</sub>'' is the ISO weekday number of the first day of the month and ''n'' and ''w'' are as defined above.

== Examples ==
{{weekday in month/doc/examples}}

== See also ==
* {{tl|WEEKDAY}}
* {{tl|Weekday in month elapsed}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox |
| <!-- CATEGORIES BELOW THIS LINE, PLEASE: -->
[[Category:Date mathematics templates]]
}}</includeonly>