View source for Template:MC/MONTHNUMBER/doc

{{Documentation header}}
This template returns the cyclic integer month number (between 1 and 12) of the month whose real number is in parameter. Alternatively, the month can be given with its English name (complete or abbreviated to 3 characters, with capitals or small letters).

== Usage ==

Does not play nicely with "subst:"

; Syntax<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|</nowiki></code>''month''<code><nowiki>}}</nowiki></code>
* The ''month'' value is interpreted modulo 12 (extra leading zeroes are ignored, negative numbers are accepted, all numbers are rounded to floor).
* If the month name is unspecified, it defaults to the current month.

; Examples for all standard English month names<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|january}}</nowiki></code> returns {{MONTHNUMBER|january}}
: <code><nowiki>{{MONTHNUMBER|february}}</nowiki></code> returns {{MONTHNUMBER|february}}
: <code><nowiki>{{MONTHNUMBER|march}}</nowiki></code> returns {{MONTHNUMBER|march}}
: <code><nowiki>{{MONTHNUMBER|april}}</nowiki></code> returns {{MONTHNUMBER|april}}
: <code><nowiki>{{MONTHNUMBER|may}}</nowiki></code> returns {{MONTHNUMBER|may}}
: <code><nowiki>{{MONTHNUMBER|june}}</nowiki></code> returns {{MONTHNUMBER|june}}
: <code><nowiki>{{MONTHNUMBER|july}}</nowiki></code> returns {{MONTHNUMBER|july}}
: <code><nowiki>{{MONTHNUMBER|august}}</nowiki></code> returns {{MONTHNUMBER|august}}
: <code><nowiki>{{MONTHNUMBER|september}}</nowiki></code> returns {{MONTHNUMBER|september}}
: <code><nowiki>{{MONTHNUMBER|october}}</nowiki></code> returns {{MONTHNUMBER|october}}
: <code><nowiki>{{MONTHNUMBER|november}}</nowiki></code> returns {{MONTHNUMBER|november}}
: <code><nowiki>{{MONTHNUMBER|december}}</nowiki></code> returns {{MONTHNUMBER|december}}

; Examples for all abbreviated English month names<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|jan}}</nowiki></code> returns {{MONTHNUMBER|jan}}
: <code><nowiki>{{MONTHNUMBER|feb}}</nowiki></code> returns {{MONTHNUMBER|feb}}
: <code><nowiki>{{MONTHNUMBER|mar}}</nowiki></code> returns {{MONTHNUMBER|mar}}
: <code><nowiki>{{MONTHNUMBER|apr}}</nowiki></code> returns {{MONTHNUMBER|apr}}
: <code><nowiki>{{MONTHNUMBER|may}}</nowiki></code> returns {{MONTHNUMBER|may}}
: <code><nowiki>{{MONTHNUMBER|jun}}</nowiki></code> returns {{MONTHNUMBER|jun}}
: <code><nowiki>{{MONTHNUMBER|jul}}</nowiki></code> returns {{MONTHNUMBER|jul}}
: <code><nowiki>{{MONTHNUMBER|aug}}</nowiki></code> returns {{MONTHNUMBER|aug}}
: <code><nowiki>{{MONTHNUMBER|sep}}</nowiki></code> returns {{MONTHNUMBER|sep}}
: <code><nowiki>{{MONTHNUMBER|oct}}</nowiki></code> returns {{MONTHNUMBER|oct}}
: <code><nowiki>{{MONTHNUMBER|nov}}</nowiki></code> returns {{MONTHNUMBER|nov}}
: <code><nowiki>{{MONTHNUMBER|dec}}</nowiki></code> returns {{MONTHNUMBER|dec}}

; Examples for all standard month numbers<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|1}}</nowiki></code> returns {{MONTHNUMBER|1}}
: <code><nowiki>{{MONTHNUMBER|2}}</nowiki></code> returns {{MONTHNUMBER|2}}
: <code><nowiki>{{MONTHNUMBER|3}}</nowiki></code> returns {{MONTHNUMBER|3}}
: <code><nowiki>{{MONTHNUMBER|4}}</nowiki></code> returns {{MONTHNUMBER|4}}
: <code><nowiki>{{MONTHNUMBER|5}}</nowiki></code> returns {{MONTHNUMBER|5}}
: <code><nowiki>{{MONTHNUMBER|6}}</nowiki></code> returns {{MONTHNUMBER|6}}
: <code><nowiki>{{MONTHNUMBER|7}}</nowiki></code> returns {{MONTHNUMBER|7}}
: <code><nowiki>{{MONTHNUMBER|8}}</nowiki></code> returns {{MONTHNUMBER|8}}
: <code><nowiki>{{MONTHNUMBER|9}}</nowiki></code> returns {{MONTHNUMBER|9}}
: <code><nowiki>{{MONTHNUMBER|10}}</nowiki></code> returns {{MONTHNUMBER|10}}
: <code><nowiki>{{MONTHNUMBER|11}}</nowiki></code> returns {{MONTHNUMBER|11}}
: <code><nowiki>{{MONTHNUMBER|12}}</nowiki></code> returns {{MONTHNUMBER|12}}

; Examples for month numbers with extra leading zero<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|01}}</nowiki></code> returns {{MONTHNUMBER|01}}
: <code><nowiki>{{MONTHNUMBER|02}}</nowiki></code> returns {{MONTHNUMBER|02}}
: <code><nowiki>{{MONTHNUMBER|03}}</nowiki></code> returns {{MONTHNUMBER|03}}
: <code><nowiki>{{MONTHNUMBER|04}}</nowiki></code> returns {{MONTHNUMBER|04}}
: <code><nowiki>{{MONTHNUMBER|05}}</nowiki></code> returns {{MONTHNUMBER|05}}
: <code><nowiki>{{MONTHNUMBER|06}}</nowiki></code> returns {{MONTHNUMBER|06}}
: <code><nowiki>{{MONTHNUMBER|07}}</nowiki></code> returns {{MONTHNUMBER|07}}
: <code><nowiki>{{MONTHNUMBER|08}}</nowiki></code> returns {{MONTHNUMBER|08}}
: <code><nowiki>{{MONTHNUMBER|09}}</nowiki></code> returns {{MONTHNUMBER|09}}

; Examples for month number underflows and overflows, from computed values<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|-1200}}</nowiki></code> returns {{MONTHNUMBER|-1200}}
: <code><nowiki>{{MONTHNUMBER|-1201}}</nowiki></code> returns {{MONTHNUMBER|-1201}}
: <code><nowiki>{{MONTHNUMBER|-1212}}</nowiki></code> returns {{MONTHNUMBER|-1212}}
: <code><nowiki>{{MONTHNUMBER|-12}}</nowiki></code> returns {{MONTHNUMBER|-12}}
: <code><nowiki>{{MONTHNUMBER|-11}}</nowiki></code> returns {{MONTHNUMBER|-11}}
: <code><nowiki>{{MONTHNUMBER|-10}}</nowiki></code> returns {{MONTHNUMBER|-10}}
: <code><nowiki>{{MONTHNUMBER|-9}}</nowiki></code> returns {{MONTHNUMBER|-9}}
: <code><nowiki>{{MONTHNUMBER|-8}}</nowiki></code> returns {{MONTHNUMBER|-8}}
: <code><nowiki>{{MONTHNUMBER|-7}}</nowiki></code> returns {{MONTHNUMBER|-7}}
: <code><nowiki>{{MONTHNUMBER|-6}}</nowiki></code> returns {{MONTHNUMBER|-6}}
: <code><nowiki>{{MONTHNUMBER|-5}}</nowiki></code> returns {{MONTHNUMBER|-5}}
: <code><nowiki>{{MONTHNUMBER|-4}}</nowiki></code> returns {{MONTHNUMBER|-4}}
: <code><nowiki>{{MONTHNUMBER|-3}}</nowiki></code> returns {{MONTHNUMBER|-3}}
: <code><nowiki>{{MONTHNUMBER|-2}}</nowiki></code> returns {{MONTHNUMBER|-2}}
: <code><nowiki>{{MONTHNUMBER|-1}}</nowiki></code> returns {{MONTHNUMBER|-1}}
: <code><nowiki>{{MONTHNUMBER|-0.9999}}</nowiki></code> returns {{MONTHNUMBER|-0.9999}}
: <code><nowiki>{{MONTHNUMBER|-0.5}}</nowiki></code> returns {{MONTHNUMBER|-0.5}}
: <code><nowiki>{{MONTHNUMBER|-0.0001}}</nowiki></code> returns {{MONTHNUMBER|-0.0001}}
: <code><nowiki>{{MONTHNUMBER|0}}</nowiki></code> returns {{MONTHNUMBER|0}}
: <code><nowiki>{{MONTHNUMBER|0.0001}}</nowiki></code> returns {{MONTHNUMBER|0.0001}}
: <code><nowiki>{{MONTHNUMBER|0.5}}</nowiki></code> returns {{MONTHNUMBER|0}}
: <code><nowiki>{{MONTHNUMBER|0.9999}}</nowiki></code> returns {{MONTHNUMBER|0.9999}}
: <code><nowiki>{{MONTHNUMBER|12.0001}}</nowiki></code> returns {{MONTHNUMBER|12.0001}}
: <code><nowiki>{{MONTHNUMBER|12.5}}</nowiki></code> returns {{MONTHNUMBER|12.5}}
: <code><nowiki>{{MONTHNUMBER|12.9999}}</nowiki></code> returns {{MONTHNUMBER|12.9999}}
: <code><nowiki>{{MONTHNUMBER|13}}</nowiki></code> returns {{MONTHNUMBER|13}}
: <code><nowiki>{{MONTHNUMBER|14}}</nowiki></code> returns {{MONTHNUMBER|14}}
: <code><nowiki>{{MONTHNUMBER|24}}</nowiki></code> returns {{MONTHNUMBER|24}}
: <code><nowiki>{{MONTHNUMBER|1200}}</nowiki></code> returns {{MONTHNUMBER|1200}}
: <code><nowiki>{{MONTHNUMBER|1201}}</nowiki></code> returns {{MONTHNUMBER|1201}}
: <code><nowiki>{{MONTHNUMBER|1212}}</nowiki></code> returns {{MONTHNUMBER|1212}}

; Example for invalid month name<nowiki>:</nowiki>
: <code><nowiki>{{MONTHNUMBER|xx}}</nowiki></code> returns {{MONTHNUMBER|xx}}

=== See also ===

* {{tl|Age}}
* {{tl|Birth date and age}}
* {{tl|MONTHNAME}}

<includeonly>
[[Category:Data templates]]

[[ja:テンプレート:MONTHNUMBER]]
[[nl:Sjabloon:MONTHNUMBER]]
[[ru:Шаблон:MONTHNUMBER]]
[[th:แม่แบบ:MONTHNUMBER]]
</includeonly><noinclude>
[[nl:Sjabloon:MONTHNUMBER/doc]]
[[ru:Шаблон:MONTHNUMBER/док]]
[[th:แม่แบบ:MONTHNUMBER/doc]]
</noinclude>