CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法

2024/09/07 2024/09/27

CakePHP4のFrozenDateで1ヵ月前、今月1日、来月末などの条件を指定して日付を算出する方法

　
プログラムを作成する際に、下記のような特定の条件に基づいて日付を算出する場合があるかと思います。
・先月の 1日
・来月の月末
・1ヵ月前の日付
　
CakePHP4では「FrozenTime」「FrozenDate」という便利な関数が用意されていますので、これを使用すると簡単に算出することができますので、ご紹介します。
　
　

CakePHPで「FrozenDate」を使用して指定の日付を取得する 3つの方法

　
CakePHPの「FrozenDate」を使用して、例えば「今月の最終日」を取得する記述方法は下記の 3つあります。
　
　
まず最初に、use句で使用する処理を設定します。
（「FrozenDate」と「FrozenTime」の違いについては後述します。）
　

use Cake\I18n\FrozenDate;  // FrozenDate を使用する場合
use Cake\I18n\FrozenTime;  // FrozenTime を使用する場合

1 2	use Cake\I18n\FrozenDate; // FrozenDate を使用する場合 use Cake\I18n\FrozenTime; // FrozenTime を使用する場合

　
続けて、Controller内の Action内で下記を記述します。
　

// modify を使用する方法
$today = new FrozenDate();
$lastDay = $today->modify('last day of this month');
$firstDay = $today->modify('first day of this month');

// new FrozenDate を使用する方法
$lastDay = new FrozenDate("last day of this month");

// FrozenDate::parse を使用する方法
$lastDay = FrozenDate::parse("last day of this month");

// modify を使用する方法

$today = new FrozenDate();

$lastDay = $today->modify('last day of this month');

$firstDay = $today->modify('first day of this month');

// new FrozenDate を使用する方法

$lastDay = new FrozenDate("last day of this month");

// FrozenDate::parse を使用する方法

$lastDay = FrozenDate::parse("last day of this month");

　
いずれの場合も、結果は下記のようなオブジェクトとして取得できます。
　

Cake\I18n\FrozenDate::__set_state(array(
   'date' => '2024-08-01 00:00:00.000000',
   'timezone_type' => 3,
   'timezone' => 'Asia/Tokyo',
))

Cake\I18n\FrozenDate::__set_state(array(

'date' => '2024-08-01 00:00:00.000000',

'timezone_type' => 3,

'timezone' => 'Asia/Tokyo',

))

CakePHPで「FrozenDate」を使用して様々な条件を指定する方法

　
先のサンプルでは「last day of this month」と記述して、「今月末の日付」を取得していましたが、「last day of this month」を以下のように書き換えることで、いろいろな条件の日付を取得することができます。
　

// 今月末の日付（「last day」で月末の日付、「this month」で今月）
var_export( FrozenDate::parse("last day of this month") );

// 今月の初日（「first day」で月初の日付）
var_export( FrozenDate::parse("first day of this month") );

// 来月末の日付（「next month」で来月）
var_export( FrozenDate::parse("last day of next month") );

// 先月末の日付（「last month」で先月）
var_export( FrozenDate::parse("last day of last month") );

// 今日から 5日後（前後を「+」「-」で表記もできる）
var_export( FrozenDate::parse("+5 day") );

// 今日から 2ヶ月後（前後を「+」「-」で表記もできる）
var_export( FrozenDate::parse("+2 month") );

// 3年前の 3日後（「-3 year」「+3day」を組み合わせることもできる）
var_export( FrozenDate::parse("-3 year +3day") );

// 3年前（「ago」を付けると過去に）
var_export( FrozenDate::parse("3 year ago") );

// 3年後（「ago」を付けなければ未来に）
var_export( FrozenDate::parse("3 year") );

// 3か月後の月末日
var_export( FrozenDate::parse("last day of 3 month") );

// 5か月前の初日
var_export( FrozenDate::parse("first day of -5 month") );

// 5か月前の初日（「ago」を付けると過去に）
var_export( FrozenDate::parse("first day of 5 month ago") );

// 5か月後の初日（「ago」を付けなければ未来に）
var_export( FrozenDate::parse("first day of 5 month") );

// 「2012-02」の月末日（「2012-02」のように具体的な月の指定もできる）
var_export( FrozenDate::parse("last day of 2012-02") );

// 「2012-02-12」の月末日（「2012-02-12」のように具体的な日付の指定もできる）
var_export( FrozenDate::parse("last day of 2012-02-12") );

// 今年の 2月の月末日（「February」のように月を指定する事もできる。年を指定しない場合は今年の 2月）
var_export( FrozenDate::parse("last day of February") );

// 2020年 2月の月末日（「February」「2020年」を組み合わせることもできる）
var_export( FrozenDate::parse("last day of February 2020") );

// 今月末の日付（「last day」で月末の日付、「this month」で今月）

var_export( FrozenDate::parse("last day of this month") );

// 今月の初日（「first day」で月初の日付）

var_export( FrozenDate::parse("first day of this month") );

// 来月末の日付（「next month」で来月）

var_export( FrozenDate::parse("last day of next month") );

// 先月末の日付（「last month」で先月）

var_export( FrozenDate::parse("last day of last month") );

// 今日から 5日後（前後を「+」「-」で表記もできる）

var_export( FrozenDate::parse("+5 day") );

// 今日から 2ヶ月後（前後を「+」「-」で表記もできる）

var_export( FrozenDate::parse("+2 month") );

// 3年前の 3日後（「-3 year」「+3day」を組み合わせることもできる）

var_export( FrozenDate::parse("-3 year +3day") );

// 3年前（「ago」を付けると過去に）

var_export( FrozenDate::parse("3 year ago") );

// 3年後（「ago」を付けなければ未来に）

var_export( FrozenDate::parse("3 year") );

// 3か月後の月末日

var_export( FrozenDate::parse("last day of 3 month") );

// 5か月前の初日

var_export( FrozenDate::parse("first day of -5 month") );

// 5か月前の初日（「ago」を付けると過去に）

var_export( FrozenDate::parse("first day of 5 month ago") );

// 5か月後の初日（「ago」を付けなければ未来に）

var_export( FrozenDate::parse("first day of 5 month") );

// 「2012-02」の月末日（「2012-02」のように具体的な月の指定もできる）

var_export( FrozenDate::parse("last day of 2012-02") );

// 「2012-02-12」の月末日（「2012-02-12」のように具体的な日付の指定もできる）

var_export( FrozenDate::parse("last day of 2012-02-12") );

// 今年の 2月の月末日（「February」のように月を指定する事もできる。年を指定しない場合は今年の 2月）

var_export( FrozenDate::parse("last day of February") );

// 2020年 2月の月末日（「February」「2020年」を組み合わせることもできる）

var_export( FrozenDate::parse("last day of February 2020") );

　
上記は「FrozenDate::parse()」を使用して取得していますが、「$today->modify()」でも「new FrozenDate()」でも同じように条件を指定することができます。
　
また、上記は取得した値をそのまま画面に表示するために「var_export()」関数を使用しています。
「var_export()」関数については下記に記事を書いていますので、併せて参考にしてください。
「PHPのデバッグで使う print_r、var_dump、var_exportの動作の違い」
　
　
ちなみに、「FrozenDate」は日付を扱う処理ですが、時間まで扱う「FrozenTime」の方を使用する場合は、下記のように時間・分・秒を加減算することができます。
　

var_export( FrozenTime::parse("+5 hour +10 minute +20 second"));

1	var_export( FrozenTime::parse("+5 hour +10 minute +20 second"));

日時のオブジェクトは「i18nFormat()」を使用して表示

　
取得した日時のオブジェクトですが、文字列として表示する場合は、「i18nFormat()」を使用して表示したいフォーマットに変換します。
　

// 現在日時をオブジェクトとして生成
$today     = new FrozenDate();
$todayTime = new FrozenDate();

// フォーマットを整えて出力
echo $today->i18nFormat('yyyy-MM-dd');
echo $todayTime->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

// 現在日時をオブジェクトとして生成

$today = new FrozenDate();

$todayTime = new FrozenDate();

// フォーマットを整えて出力

echo $today->i18nFormat('yyyy-MM-dd');

echo $todayTime->i18nFormat('yyyy年MM月dd日 HH:mm:ss');

　
　
ちなみに「$today」に値が入っていない場合はエラーとなりますので、「$today」に値が入っていない可能性がある場合は、下記のように値があるか否かの判定をする処理を追加しておくことをオススメします。
　

echo $today ? $today->i18nFormat('yyyy-MM-dd') : "";

1	echo $today ? $today->i18nFormat('yyyy-MM-dd') : "";

CakePHPの日付、時間を扱う処理の「FrozenDate」「FrozenTime」

　
CakePHPの日付、時間を扱う処理には「FrozenDate」「FrozenTime」とあります。
　
「FrozenDate」は、年月日を扱う関数です。
「FrozenTime」は、年月日に加え、時分秒を扱う関数です。
　
これを曖昧に使うと結構な問題が発生します。
（実際に私がそれをやってしまっていましたので．．．）
　
　
では、実際に「FrozenDate」「FrozenTime」を使用して「現在」の情報を取得してみます。
　

$date = new FrozenDate();
var_export($date);

$time = new FrozenTime();
var_export($time);

$date = new FrozenDate();

var_export($date);

$time = new FrozenTime();

var_export($time);

　
上記のように実行すると、下記の結果が得られます。
　

// FrozenDate の場合
Cake\I18n\FrozenDate::__set_state(array(
   'date' => '2024-09-01 00:00:00.000000',
   'timezone_type' => 3,
   'timezone' => 'Asia/Tokyo',
))

// FrozenTime の場合
Cake\I18n\FrozenTime::__set_state(array(
   'date' => '2024-09-01 12:12:12.345678',
   'timezone_type' => 3,
   'timezone' => 'Asia/Tokyo',
))

// FrozenDate の場合

Cake\I18n\FrozenDate::__set_state(array(

'date' => '2024-09-01 00:00:00.000000',

'timezone_type' => 3,

'timezone' => 'Asia/Tokyo',

))

// FrozenTime の場合

Cake\I18n\FrozenTime::__set_state(array(

'date' => '2024-09-01 12:12:12.345678',

'timezone_type' => 3,

'timezone' => 'Asia/Tokyo',

))

　
「FrozenDate」では「時分秒」が「0（値がない）」のに対し、「FrozenTime」ではそれらが存在します。
　
　
この「FrozenDate」と「FrozenTime」の違いをよく理解せずに、「datetime型」の「created」「modified」などの日時の項目に対して SQLの抽出条件に使用すると、想定していない結果が返ってくることがあります。
　
　
例えば、「2024-08-10」～「2024-08-15」を条件に抽出しようとする場合は「FrozenDate」を使う必要があります。
「FrozenTime」を使うと、「時分秒」を持ちますので、実行した時間によって結果が変わってくる、みたいなことが発生してしまいます。
　
お気を付けください．．．
　
　

PHPでは月末に対して実行する「+1 month」は想定の結果にならない場合がある

　
PHPでは月末日を基準として「+1 month」を実行したとき、想定した結果にならない場合があるようです。
これは、CakePHPの「FrozenDate」に不具合があるのではなく、PHPの処理自体がそういう仕様で動いているためです。
　
具体的には以下の通りです。
　

$today = new FrozenDate("2024-01-31");
var_export($today);
var_export($today->modify('+1 month'));
var_export($today->modify('+2 month'));
var_export($today->modify('+3 month'));
var_export($today->modify('+4 month'));

$today = new FrozenDate("2024-01-31");

var_export($today);

var_export($today->modify('+1 month'));

var_export($today->modify('+2 month'));

var_export($today->modify('+3 month'));

var_export($today->modify('+4 month'));

　
上記を実行すると、以下のようになります。
　

'date' => '2024-01-31 00:00:00.000000'  // today
'date' => '2024-03-02 00:00:00.000000'  // +1 month
'date' => '2024-03-31 00:00:00.000000'  // +2 month
'date' => '2024-05-01 00:00:00.000000'  // +3 month
'date' => '2024-05-31 00:00:00.000000'  // +4 month

'date' => '2024-01-31 00:00:00.000000' // today

'date' => '2024-03-02 00:00:00.000000' // +1 month

'date' => '2024-03-31 00:00:00.000000' // +2 month

'date' => '2024-05-01 00:00:00.000000' // +3 month

'date' => '2024-05-31 00:00:00.000000' // +4 month

　
　
この PHPの日付の処理については、下記に詳細な仕様の説明と、対応策を書いていますので、併せて参考にしてください。
「PHPで月末から1ヶ月後「+1 month」を算出すると想定する日付にならない場合がある」
　
　

- CakePHP 3.x 4.x 5.x CakePHP4

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakeDC謹製Usersプラグインの紹介。Usersのカスタマイズとして入力項目のバリデーションの変更を、プラグインのファイルは触らずオーバーライドにより実装する方法を解説する。

: CakePHP3のデバッグキット（DebugKit）を強制的に有効、無効に変更する方法

CakePHP3に付属しているデバッグのためのツール、デバッグキットを強制的に有効化、無効化する方法を解説。初期設定では開発環境としてありそうなドメインの場合のみ有効になるように設定されている。

: CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

ID以外のカラムでアソシエーション（連携）させて詳細ページを表示させる際の考え方と注意点をサンプルソースを用いて解説しています。

: CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

CakePHP4でcontrollerで実行したバリデーションの結果をModelのバリデーション結果に追加するメソッド「setError()」「setErrors()」の使い方の解説。

: cakephp3 カスタムバリデーションを簡易的に実装する方法

CakePHP3の独自のバリデーションをテーブルクラス内に簡単に記述する方法を解説。他のテーブルクラスでは使えないが、記述する量は少なく実装できるため、他で使わない処理を書くのには便利。

: CakePHP3の1対多での連携を中間テーブルを使った多対多の連携に変更するときの手順

CakePHP3で「1対多」の連携を中間テーブルを利用した「多対多」の連携に変更するときの手順のまとめ。中間テーブルの設定やModelの変更などを間違いやすい箇所を指摘しながらの解説。

: CakePHP 2.3　Search Pluginで検索処理　その３入力エリア一つで複数の項目を同時に検索する方法

CakePHPの検索プラグイン Search Pluginの検索処理の中で入力エリア一つで複数の項目を同時に検索する方法を解説。

: CakePHP4で公開側と管理側のデザインテンプレートを分ける方法・setLayout()

CakePHP4でデフォルトのレイアウトファイル「default.php」は管理側に使用し、これとは別のデザインを公開側のページに設定したい、を実装する方法を解説。

: CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

入力された値によってバリデーション（入力チェック）の内容を切り替える。その処理をCakePHPで実装する方法を解説。条件ごとに unset関数を使ってバリデーションを削除する、という方法を採る。

: CakePHP3のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

CakePHP3の英語のメッセージを日本語化（多言語化）する手順を解説。オリジナルのメッセージを作成する方法やプログラムで文言を追加する場合の対応なども解説。

PREV: CakePHP4のcake cache clear_allでPermission deniedはパーミッションの変更が必要
NEXT: PHPで1ヵ月前、先月、今月1日、来月末の日付などの算出はDateTimeImmutableを使う

日	月	火	水	木	金	土
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30
31

CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法

CakePHP4のFrozenDateで1ヵ月前、今月1日、来月末などの条件を指定して日付を算出する方法

CakePHPで「FrozenDate」を使用して指定の日付を取得する 3つの方法

CakePHPで「FrozenDate」を使用して様々な条件を指定する方法

日時のオブジェクトは「i18nFormat()」を使用して表示

CakePHPの日付、時間を扱う処理の「FrozenDate」「FrozenTime」

PHPでは月末に対して実行する「+1 month」は想定の結果にならない場合がある

CakePHP4の関連記事

GoogleAdwords

GoogleAdwords

Message コメントをキャンセル

関連記事

CakePHP3のCakeDC/Usersのバリデーションのカスタマイズ方法解説

CakePHP3のデバッグキット（DebugKit）を強制的に有効、無効に変更する方法

CakePHP 2.3　ID以外のカラムでアソシエーション（連携）をさせる場合の詳細ページの注意点

CakePHP4でcontrollerで実行したバリデーションエラーをmodelのにマージする方法

cakephp3 カスタムバリデーションを簡易的に実装する方法

CakePHP3の1対多での連携を中間テーブルを使った多対多の連携に変更するときの手順

CakePHP 2.3　Search Pluginで検索処理　その３入力エリア一つで複数の項目を同時に検索する方法

CakePHP4で公開側と管理側のデザインテンプレートを分ける方法・setLayout()

CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

CakePHP3のメッセージ日本語化の設定（国際化と地域化の機能の使い方の解説）

WordPress投稿にPHPを記述するショートコードの使い方add_shortcode

コピーコンテンツ対策.htaccessで直リンク禁止しリダイレクトで対応

評価点投票プラグイン10個を比較！WordPressで口コミサイトを構築

BackWPupでバックアップ・リストア（復元）の具体的手順

コンパクトキーボード・KEK-EA9AU・FKB1420の魅力