「テンプレート:Checkdate/doc」を編集中

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{使用箇所の多いテンプレート|400,000以上}}</includeonly>
「yyyy-mm-dd」「Month yyyy」形式の日付を「yyyy年m月」形式に変換します。「yyyy年m月」形式の日付を指定された場合にはそのまま返します。

== 基本機能 ==
* 「yyyy年m月」形式は、変換せずそのまま返します。
** 例：{{テンプレートの使用例|templatename=Checkdate|{{#time:Y年1月}}}}
** 例：{{テンプレートの使用例|templatename=Checkdate|{{#time:Y年}}12月}}
* 「月」の文字より後に日や時刻などがある場合は取り除きます。
** 例：{{テンプレートの使用例|templatename=Checkdate|{{#time:Y年Fj日}}}}
* 「Month yyyy」形式は、「yyyy年m月」形式に変換します。
** 例：{{テンプレートの使用例|templatename=Checkdate|{{#time:F Y|now|en}}}}
* 「yyyy-mm」、「yyyy-mm-dd」形式は、「yyyy年m月」形式に変換します。
** 例：{{テンプレートの使用例|templatename=Checkdate|{{#time:Y-m-d}}}}
* 日付を認識できない場合、または何も指定されない場合には、オプションのdefaultdateが指定されている場合を除き、何も返しません。
** 例：{{テンプレートの使用例|templatename=Checkdate|あいうえお}}
** 例：{{テンプレートの使用例|templatename=Checkdate|}}

== 日本語版で追加されたパラメータ ==
* defaultdate
** 日付を認識できない場合、または何も指定されない場合の既定値を指定できます。先頭の3文字が「エラー」だった場合に限り、{{Tl|Error}}を呼び出します。

== 英語版との相違点 ==
* このテンプレートの内部で使用している<nowiki>{{#time}}</nowiki>は仕様上、特定の書式での入力に対してユーザーが意図しない認識をする場合があり、その懸念を回避するため、「Month, yyyy」形式は、日本語版ではサポートしていません。
* 同じ問題により、「yyyy年m月〜」、「yyyy-mm〜」形式以外では、[[2059年]]以前の日付のみを対象としています。<!-- この範囲外の日付はこのテンプレートの用途としては必要が無く、問題回避ロジックをシンプルにするための処置。 2059年が近づいたら（?）対処してください。-->

== 廃止した機能 ==
* 「yyyy年m月」形式で、1桁の月に0を付けて2桁で指定された月を1桁に変換する機能は廃止しました。<!-- 2013年8月廃止 -->

== 備考 ==
* 「yyyy年m月」形式（「月」の文字が使用されている場合）においては、正しくない日付を指定された場合でも基本的にはその年月をそのまま返します。<br /><!--
-->「月」の文字が使用されているのに「年」の文字の代わりに「-」（ハイフン）等が使用されている場合にも「年」には変換しません。<!-- 注意：これをエラー扱いとしない仕様は{{Cite web}}で使用している。--><!--2011年10月2日現在 -->
* 「yyyy年m月」形式でない場合において、当<nowiki>{{Checkdate}}</nowiki>が回避している<nowiki>{{#time}}</nowiki>の問題は次のとおりです。
** 「yyyymm」の入力を意図して6桁の数字列を指定した場合に、時刻として解釈することができるときはエラーにならず時刻として解釈される。当<nowiki>{{Checkdate}}</nowiki>では、オプションの defaultdateが指定されている場合を除き、何も返しません。
*** 例：<nowiki>{{#time:Y年n月j日 (D) H:i:s (T)|200901}}</nowiki> → {{#time:Y年n月j日 (D) H:i:s (T)|200901}}
** 「Month, yyyy」を意図した入力の場合（Monthと yyyyの間に「,」（カンマ）を挿入した場合）、時刻として解釈することができるときにはyyyyの数字が時刻として解釈され、そうでなければ年として解釈される。当<nowiki>{{Checkdate}}</nowiki>では、オプションのdefaultdateが指定されている場合を除き、何も返しません。
*** 例：<nowiki>{{#time:Y年n月j日 (D) H:i:s (T)|September, 2008}}</nowiki> → {{#time:Y年n月j日 (D) H:i:s (T)|September, 2008}} 
** 指定されている月が[[小の月]]（2・4・6・9・11）で、なおかつ年と日が指定されていない場合、それを閲覧している時点が[[大の月]]（1・3・5・7・8・10・12）の月末日のときに月数が翌月に繰り上がる。このバグを回避するため、当<nowiki>{{Checkdate}}</nowiki>の内部では、年と月の両方が指定されている入力のみ扱っています。
*** 例：<nowiki>{{#time:Y年F|February}}</nowiki> → 毎月28日（閏年の場合は29日）までは正常ですが、その後は3月に繰り上がります。
== 関連項目 ==
* [[テンプレート:年月日]]：西暦年・月・日の引数を「XXXX年XX月XX日」に整形する。
* [[テンプレート:時分秒]]：時刻を「XX時XX分XX秒」に整形する。
<includeonly>{{sandbox other||
{{デフォルトソート:{{TEMPLATENAME}}}}
<!-- カテゴリは以下に追加してください -->
[[Category:メタテンプレート]]
[[Category:暦と日付と時間のテンプレート]]
}}</includeonly>