PowerCMS™
アルファサードのゴールデンウィーク休業について を追加しました。
[ブログ] PowerCMS 6 でのアップデートまとめ を追加しました。
[新着情報] 多要素認証設定画面の QR コードが表示されない問題への対策ファイル を追加しました。
[新着情報] PowerCMSクラウド 月額費用の価格改定に関する追加情報を公開します を追加しました。

MTRelativeDate

ホーム > PowerCMS > ドキュメント > テンプレートタグリファレンス > MTRelativeDate

MTRelativeDate

N日後の年月日のように、差分を指定すると特定日時を基準にした過去あるいは未来の日時を出力します。

このタグは PowerCMS 6.4 以降で利用できます。

使い方

<!-- 現在日時を基準とした7日前の日付を出力する-->
<$MTRelativeDate ago="7day"$>

<!-- 記事の公開日時を基準とした1か月後の日付を出力する-->
<$MTRelativeDate tag="EntryDate" later="1month"$>

<!--年末セールのお知らせ-->
年末セールは「<$MTEntryDate language="ja"$>」から「<$MTRelativeDate tag="EntryDate" ago="7day" language="ja"$>」まで開催します。

モディファイア

tag="日付を出力するテンプレートタグ名"

基準としたい日付を出力するテンプレートタグ名を指定します。(初期値 : Date)

例えば記事の公開日時 (MTEntryDate) を基準にしたい場合は EntryDate と指定します。(頭の MT は不要) tag が未指定の場合は MTDate (現在の日時) が基準になります。

ts と tag の両方が指定された場合は ts の指定を優先します。

ts="YYYYmmddHHMMSS"

基準となる日時を YYYYmmddHHMMSS 形式の14桁 (年月日時分秒) で指定します。

例えば「2023年1月1日」を記述にしたい場合は 20230101000000 と時分秒も含めて指定します。

ts と tag の両方が指定された場合は ts の指定を優先します。

ago="過去への差分"

過去の日付への差分を「数値+日付の種類」のフォーマットで指定します。

例えば基準より「7日前」の日付を出力したい場合は 7day と指定します。日付の種類として指定できる値は下記になり複数同時に指定はできません。

日付の種類種類に対応する指定指定例指定例の意味
年year1year1年前
月month2month2か月前
週week3week3週間前
日day4day4日前
時hour5hour5時間前
分minute6minute6分前
秒second7second7秒前

ago と lator の両方が指定された場合は ago の指定を優先します。

later="未来への差分"

未来の日付への差分を「数値+日付の種類」のフォーマットで指定します。

例えば基準より「3月後」の日付を出力したい場合は 3month と指定します。日付の種類として指定できる値は下記になり複数同時に指定はできません。

日付の種類種類に対応する指定指定例指定例の意味
年year8year8年後
月month9month9か月後
週week10week10週間後
日day11day11日後
時hour12hour12時間後
分minute13minute13分後
秒second14second14秒後

ago と lator の両方が指定された場合は ago の指定を優先します。

format="XX" や language="XX"

format や language など日付に関するテンプレートタグで利用できるモディファイアが利用できます。

MTRelativeDate と関連のあるテンプレートタグ (20)