指定したある日からある日までの年数を表示するスニペットです。年数は満何年と何年目のどちらで出力するかを指定できます。年齢や経過年数の表示、カウントダウンなどの用途に使えます。
[[phiYears? &begin=`1998-05-12`]]ドキュメントの更新頻度、またはキャッシュをクリアする頻度が年に1回未満の場合は、スニペットのキャッシュを無効にするための[!スニペット名? &パラメータ名=`値`!]という書式を利用してください。
| パラメータ名 | 省略 | デフォルト値 | 説明 |
|---|---|---|---|
| begin | 可 | 現在の年月日 | 基準となる年月日。年、月、日はそれぞれ、「-」、「.」、「/」のいずれかの文字で区切り、YYYY-MM-DDのような形式で指定する。 |
| end | 可 | 現在の年月日 | 年数を求める年月日。年、月、日はそれぞれ、「-」、「.」、「/」のいずれかの文字で区切り、YYYY-MM-DDのような形式で指定する。 |
| full | 可 | 1 | 年数の計算方法。「0」以外、空文字以外の値を指定すると、beginパラメータからendパラメータまでの年数が満年かを出力する。「0」、空文字を指定すると、beginパラメータからendパラメータまでの年数が何年目かを出力する。 |
1991年8月6日から現在までが満何年かを表示したい場合、次のようにスニペットコールします。
今年は<abbr title="World Wide Web">WWW</abbr>誕生から満[[phiYears? &begin=`1991-08-06`]]年この例では次のように出力されます。
今年はWWW誕生から満27年
1945年8月15日から現在までが何年目かを表示したい場合、次のようにスニペットコールします。
今年は戦後[[phiYears? &begin=`1945-08-15` &full=`0`]]年目この例では次のように出力されます。
今年は戦後73年目
1879年3月14日から1955年4月18日までが何年間かを表示したい場合、次のようにスニペットコールします。
アルベルト・アインシュタインは享年[[phiYears? &begin=`1879-03-14` &end=`1955-04-18`]]歳この例では次のように出力されます。
アルベルト・アインシュタインは享年76歳
現在から2101年1月1日までがあと何年かを表示したい場合、次のようにスニペットコールします。
22世紀まであと[[phiYears? &end=`2101-01-01`]]年この例では次のように出力されます。
22世紀まであと82年