1. 導入：なぜDateTimeImmutableが重要なのか
PHPで日付計算を行う際、多くのエンジニアがDateTimeクラスを使用しますが、このクラスには「ミュータブル（変更可能）」という特性があります。add()やmodify()といったメソッドを呼び出すと、元のオブジェクト自体が書き換わってしまうため、計算の過程で元の値を保持しておきたい場合に予期せぬバグを引き起こす原因となります。本記事では、この副作用を回避し、堅牢なコードを書くために必須となる「DateTimeImmutable」クラスの活用法を解説します。
2. 基礎知識：ミュータブルとイミュータブルの違い
PHPのDateTimeクラスは「ミュータブル」であり、オブジェクトの状態を直接変更します。これに対し、DateTimeImmutableクラスは「イミュータブル（変更不可能）」です。イミュータブルなオブジェクトは、操作を行うたびに新しいインスタンスを生成して返すため、元のオブジェクトの値は一切変化しません。これにより、変数の代入や関数の引数として渡す際にも、状態の変化を気にせず安全に扱うことができます。
3. 実装・解決策：安全な日付計算
日付計算を行う際は、基本的にDateTimeImmutableを使用する癖をつけるのが現代的なPHP開発のベストプラクティスです。もし外部ライブラリ等からDateTimeオブジェクト（ミュータブル）を受け取った場合でも、createFromMutable()メソッドを使用することで、即座にイミュータブルな形へ変換して安全な計算環境を整えることができます。
4. サンプルプログラム：週の週末を求める実装例
以下は、今日の日付を基準に土曜日と日曜日を算出するサンプルです。元のオブジェクトを汚染せずに計算結果を取得しています。
format(‘w’);
// 土曜日までの差分を計算
$diff = 6 – $w;
// add()を実行しても、$nowの値は変化しない
$sat = $now->add(new DateInterval(‘P’ . $diff . ‘D’));
$sun = $now->add(new DateInterval(‘P’ . ($diff + 1) . ‘D’));
// 結果を表示
echo “土曜日: ” . $sat->format(‘Y-m-d’) . PHP_EOL;
echo “日曜日: ” . $sun->format(‘Y-m-d’) . PHP_EOL;
// 参考：DateTimeオブジェクトをDateTimeImmutableに変換する方法
$mutableDate = new DateTime();
$immutableDate = DateTimeImmutable::createFromMutable($mutableDate);
?>
5. 応用・注意点：現場で陥りやすい罠
現場で最も多いトラブルは「関数内でDateTimeを渡して操作した結果、呼び出し元の変数まで書き換わっていた」というケースです。特に複雑なロジックの中で日付計算を繰り返す場合、DateTimeクラスを使用していると追跡困難なバグを生みます。
回避策として、関数の引数で日付を受け取る際は、可能な限りDateTimeImmutableを型指定（Type Hinting）することをお勧めします。また、既存の古いコードベースでDateTimeが多用されている場合は、処理の入り口でDateTimeImmutableへ変換する処理を挟むことで、影響範囲を最小限に留めることが可能です。常に「変更を伴う操作か、新しい値が欲しいだけか」を意識し、後者の場合は迷わずDateTimeImmutableを選択してください。