Phize on the Web

phiYearsスニペット(1.1.0) - MODx

指定したある日からある日までの年数を表示するスニペットです。年数は満何年と何年目のどちらで出力するかを指定できます。年齢や経過年数の表示、カウントダウンなどの用途に使えます。

インストール

  1. MODxマネージャのナビゲーションから「リソース」→「リソース管理」の「スニペット」タブを開く。
  2. 「スニペットの作成」をクリックし、「全般」タブを開く。
  3. 「プラグイン名」にphiYearsと入力し、ダウンロードしたファイルの内容を「スニペット コード (php)」にコピー&ペーストする。
  4. 「保存」をクリックしてスニペットを保存する。

書式

[[phiYears? &begin=`1998-05-12`]]

ドキュメントの更新頻度、またはキャッシュをクリアする頻度が年に1回未満の場合は、スニペットのキャッシュを無効にするための[!スニペット名? &パラメータ名=``!]という書式を利用してください。

パラメータ

phiYearsスニペットのパラメータ
パラメータ名 省略 デフォルト値 説明
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誕生から満25年

1945年8月15日から現在までが何年目かを表示したい場合、次のようにスニペットコールします。

今年は戦後[[phiYears? &begin=`1945-08-15` &full=`0`]]年目

この例では次のように出力されます。

今年は戦後71年目

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世紀まであと84年

バージョン履歴

Version 1.1.0
年数を満y年とy年目のどちらで表示するかを指定するfullパラメータを追加。スニペット名をphiElapsedYearsからphiYearsに変更。
Version 1.0.0
公開。
Copyright© 2006-2017 Phize on the Web All Rights Reserved.