PHPで1ヵ月前、先月、今月1日、来月末の日付などの算出はDateTimeImmutableを使う

2024/09/27

PHPで1ヵ月前、先月、今月1日、来月末の日付などの算出はDateTimeImmutableを使う

　
プログラムを作成する際に、下記のような特定の条件に基づいて日付を算出する場合があるかと思います。
・先月の 1日
・来月の月末
・1ヵ月前の日付
　
「CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法」
上記の記事では CakePHP4での処理方法を紹介しました。
CakePHP4には「FrozenTime」「FrozenDate」という便利な関数が用意されていますので、これを使用すると簡単に算出することができます、と。
　
この記事では、CakePHPで用意された関数ではなく、PHP自体の関数ではどう対応するのか、それを紹介します。
　
ずばり、PHPでは「DateTimeImmutable」を使用します。
　
PHP公式　DateTimeImmutable
https://www.php.net/manual/ja/datetimeimmutable.construct.php
　
　

DateTimeImmutableは日付のオブジェクトを生成する

　
「DateTimeImmutable」は日付のオブジェクトを生成します。
　
　

DateTimeImmutableの基本形：現在日時を取得

// 現在日時を取得
$dateImmutable = new DateTimeImmutable("now");

// 取得した時刻を出力
var_export($dateImmutable);

// 現在日時を取得

$dateImmutable = new DateTimeImmutable("now");

// 取得した時刻を出力

var_export($dateImmutable);

　
出力した結果は下記のようになります。
　

DateTimeImmutable::__set_state(array(
   'date' => '2024-09-01 12:12:12.345678',
   'timezone_type' => 3,
   'timezone' => 'Asia/Tokyo',
))

DateTimeImmutable::__set_state(array(

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

'timezone_type' => 3,

'timezone' => 'Asia/Tokyo',

))

　
現在日時を取得する際は「DateTimeImmutable()」のパラメータに「now」を指定していますが、パラメータがない場合は「now」が指定されたものとして現在日時を取得します。
　
　

DateTimeImmutableで取得した日時のオブジェクトをmodifyを利用して希望の日時を取得する

　
「DateTimeImmutable」で取得した日時のオブジェクトを「modify」を利用して希望の日時を取得する方法は下記となります。
　

// 現在日時を取得
$dateImmutable = new DateTimeImmutable("now");

// modify()を利用して希望の日時を取得
// 今月末の日付（「last day」で月末の日付、「this month」で今月）
$dateImmutable2 = $dateImmutable->modify('last day of this month');

// 現在日時を取得

$dateImmutable = new DateTimeImmutable("now");

// modify()を利用して希望の日時を取得

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

$dateImmutable2 = $dateImmutable->modify('last day of this month');

　
上記の方法で現在日時を基準として、「今月末の日付」を取得することができます。
　
　
「今月末の日付」を取得する場合は「last day of this month」を指定しますが、「今月の初日」の場合は「first day of this month」を指定します。
　
その他、多様な指定方法がありますが、指定方法は CakePHPと同じですので、下記の記事を参照してください。
「CakePHP4のFrozenDateで1ヵ月前、先月、今月1日、来月末の日付などを算出する方法」
　
　

「現在日時」を基準に「DateTimeImmutable」を使用する場合は直接指定する方法もある

　
前項では、「DateTimeImmutable」で取得した日時のオブジェクトをmodifyを利用して変換する方法を取りました。
　
しかし、「現在日時」を基準に今月末が分かればいい、という場合は下記のように「DateTimeImmutable」に直接指定する方法もあります。
　

// 「今月末の日付」を指定
$dateImmutable = new DateTimeImmutable("last day of this month");

1 2	// 「今月末の日付」を指定 $dateImmutable = new DateTimeImmutable("last day of this month");

指定した「日時」を基準に「DateTimeImmutable」＋「modify」を使用する方法もある

　
前項では「現在日時」を基準に処理する方法でしたが、指定した「日時」を基準にする場合は、最初に指定した日時のオブジェクトを作成し、それに対して modifyを指定する方法があります。
　

// 「今月末の日付」を指定
$dateImmutable = new DateTimeImmutable("2000-02-01");

// 「1日後」を指定
$dateImmutable2 = $dateImmutable->modify('+1 day');

// 「今月末の日付」を指定

$dateImmutable = new DateTimeImmutable("2000-02-01");

// 「1日後」を指定

$dateImmutable2 = $dateImmutable->modify('+1 day');

　
　
ちなみに、上記も下記のように 1行で処理することもできます。
　

$dateImmutable2 = new DateTimeImmutable("2000-02-01 +1 day");

1	$dateImmutable2 = new DateTimeImmutable("2000-02-01 +1 day");

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

　
最後になりましたが、日時のオブジェクトを表示する場合は、「format()」を使用して表示したいフォーマットに変換することができます。
　

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

// フォーマットを整えて出力
echo $today->format('Y-m-d');
echo $today->format('Y年m月d日 H:i:s');

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

$today = new DateTimeImmutable();

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

echo $today->format('Y-m-d');

echo $today->format('Y年m月d日 H:i:s');

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

echo $today ? $today->format('Y年m月d日 H:i:s') : "";

1	echo $today ? $today->format('Y年m月d日 H:i:s') : "";

　
　
フォーマットとして指定するパラメータの詳細は下記を参照してください。
PHPオフィシャル　DateTime::format
https://www.php.net/manual/ja/datetime.format.php
　
　

DateTimeImmutable と DateTime の違い

　
PHPには、日時のオブジェクトを生成する関数として「DateTimeImmutable」と「DateTime」が用意されています。
どちらも同じようなメソッドが利用できて、同じように使用することができます。
　
違いは「DateTimeImmutable」には「Immutable（不変）」と付いているように、生成されたオブジェクトは「不変」ということです。
　
その違いが分かる具体的な処理は「modify」を使用したときに現れます。
　
　
「DateTimeImmutable」を使用した場合

// 「2000-02-01」のオブジェクトを生成
$dateImmutable = new DateTimeImmutable('2000-02-01');
var_export($dateImmutable);    // 2000-02-01
echo "　<br>";

$dateImmutable2 = $dateImmutable->modify('+1 day');
var_export($dateImmutable);    // 2000-02-01
echo "　<br>";
var_export($dateImmutable2);   // 2000-02-02
echo "　<br>";

// 「2000-02-01」のオブジェクトを生成

$dateImmutable = new DateTimeImmutable('2000-02-01');

var_export($dateImmutable); // 2000-02-01

echo "　 ";

$dateImmutable2 = $dateImmutable->modify('+1 day');

var_export($dateImmutable); // 2000-02-01

echo "　 ";

var_export($dateImmutable2); // 2000-02-02

echo "　 ";

　
　
「DateTime」を使用した場合

// 「2000-02-01」のオブジェクトを生成
$dateDateTime = new DateTime('2000-02-01');
var_export($dateDateTime);    // 2000-02-01
echo "　<br>";

$dateDateTime2 = $dateDateTime->modify('+1 day');
var_export($dateDateTime);    // 2000-02-02
echo "　<br>";
var_export($dateDateTime2);   // 2000-02-02
echo "　<br>";

// 「2000-02-01」のオブジェクトを生成

$dateDateTime = new DateTime('2000-02-01');

var_export($dateDateTime); // 2000-02-01

echo "　 ";

$dateDateTime2 = $dateDateTime->modify('+1 day');

var_export($dateDateTime); // 2000-02-02

echo "　 ";

var_export($dateDateTime2); // 2000-02-02

echo "　 ";

　
上記のように、「modify('+1 day')」を実行すると、「DateTimeImmutable」の方の「$dateImmutable」の日時は変更されませんが、「DateTime」の方の「$dateDateTime」の日時は「+1 day」されて、「$dateDateTime2」と同じ値になっています。
　
つまり、変わる「DateTime」と、不変の「DateTimeImmutable」というワケです。
　
この仕様を理解したうえで、活用するために「DateTime」を使用するのであれば問題ないですが、無用なバグ混入を避けるためには「DateTimeImmutable」を使っておく方が無難だと思いますね。
特に複数人で開発を行う場合は、全員にこの理解が求められますので。
　
　

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

　
PHPでは月末日を基準として「+1 month」を実行したとき、想定した結果にならない場合があるようです。
これはバグではなく、PHPの仕様だ！ということのようで、PHPで日付を扱う場合はしっかりと認識をしておく必要がある仕様かと思います。
　
具体的には以下の通りです。
　

$today = new DateTimeImmutable("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 DateTimeImmutable("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」を算出すると想定する日付にならない場合がある」

- PHP・Smarty・ECCUBE

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

Message コメントをキャンセル

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

: CentOS6、7のPHPを5.3から5.6、7.0、7.1にバージョンアップする手順の解説

CentOS6系、7系のPHPバージョンを5.3から5.6、7.0、7.1にアップする作業手順と解説。yum updateコマンドを使い作業時間は約10分。コマンドの解説や引数の意味なども解説しているので役に立つはず。

: フォルダを指定してファイルのパーミッションを変更するプログラム

フォームからフォルダ、パーミッションを指定しパーミッションを変更するサンプルプログラムの解説です。

: 数値がMySQLのint(11)に保存できない！PHPの変数が本当にint型か確認！

PHPでintegerとdoubleが混在するような計算をする場合は要注意！計算結果が整数値であっても途中で使用する変数にdoubleの値が入っているときは計算結果がintegerではない場合があります。

: ECCUBEの注文完了画面注文番号と商品情報を編集するCRITEO（クリテオ）タグを編集

ECCUBEの注文完了画面にクリテオのタグを編集する方法を紹介。標準機能では完了画面に注文IDや購入商品の情報を渡さないため改修が必要です。

: Smartyのテンプレート内の処理で計算、加工をする方法

Smartyのテンプレート上で変数を計算する、加工する方法を解説します。

: ECCUBEでテンプレートファイルのファイルサイズは10MB以下のものを使用してくださいのエラーが出た場合

テンプレートをアップロードする際にファイルサイズが大きすぎてエラーが表示される際の対処方法解説。パラメータ設定で設定する制限について解説を行っています。

: include、requireのパス指定をdirname(__FILE__)、__DIR__と書く理由

include、requireのパスの指定を dirname(__FILE__)、__DIR__で記述する理由に付いて解説。相対パス、絶対パスを直書き、パスを書かない場合は何が問題かを説明。

: ECCUBEの新規追加ページがInternal Server Error・Not Foundに

ECCUBEで新規追加したページがInternal Server Errorに！原因はファイルのパーミッションの場合が多くその対処方法とプログラムの修正ポイントを解説。Not Foundも解説。

: PHPのスクレイピングライブラリ「PHP Simple HTML DOM Parser」の使い方

PHPのスクレイピングライブラリ「PHP Simple HTML DOM Parser」の使い方を解説。要素を取得する方法、そこから属性を取得する方法を解説。また、マニュアルにはない注意点なども解説。

: PHPで月末から1ヶ月後「+1 month」を算出すると想定する日付にならない場合がある

PHPでは月末の1ヶ月後が想定した日付にならない場合がある。原因はバグではなくPHPの1ヶ月後の定義によるもの。なので必要とする日付を定義しそれに合わせてDateTime、modifyを使用して算出方法を解説している。