技術資料

PHPで扱う日付と時刻の基礎

PHPで日付時刻関連の値を扱うときは、DateTimeImmutableクラスを使うのが便利です。

DateTimeクラスでも良いんですが、PHPの公式マニュアルによると、

警告 DateTime クラスのメソッドをコールすると、 そのインスタンスにカプセル化された情報が変更されます。 そうした変更を防ぎたい場合には、新しいオブジェクトを作るために clone 演算子を使わなければいけません。 オブジェクトの変更を防ぐ、望ましい挙動をデフォルトで実現するには、 DateTime ではなく、 DateTimeImmutable を使います。

とのことなので、基本的には DateTimeImmutable クラスを使うようにしておくのが良さそう。

$date = new DateTimeImmutable();
echo $date->format("Y-m-d H:i:s"); // 2024-12-07 09:13:22

MySQL等のデータベースのdatetime型の値を引っ張ってきて、そのまま突っ込めば書式の整形も簡単。
フォーマットの指定は、DateTimeInterface::formatを参照。

// $db_datetime に MySQLデータベースのdatetime型の値が入ってると仮定
$date = new DateTimeImmutable($db_datetime);
echo $date->format("Y.m.d(D)"); // 2024.12.07(Sun)

n分後、n日後などの加算、n分前、n日前などの減算も簡単。
modifierの書式についてはサポートする日付と時刻の書式を参照。

$date = new DateTimeImmutable();
echo $date->modify("+5 minutes")->format("Y-m-d H:i:s"); // 5分後
echo $date->modify("+1 days")->format("Y-m-d H:i:s"); // 1日後
echo $date->modify("-5 minutes")->format("Y-m-d H:i:s"); // 5分前
echo $date->modify("-1 days")->format("Y-m-d H:i:s"); // 1日前

「次の日曜日」みたいな指定ができるのはありがたいケースが時々ありますね。

$date = new DateTimeImmutable();
echo $date->modify("sunday")->format("Y-m-d H:i:s"); // 次の日曜日;

値の現在時刻との比較とかも簡単。

$current_time = new DateTimeImmutable(); // 現在時刻
// $db_datetime に MySQLデータベースのdatetime型の値(例えば特定のURLの表示有効期限)が入ってると仮定
if($current_time > new DateTimeImmutable($db_datetime)){
    // 有効期限切れのエラー処理
    die('URLの有効期限切れです');
}

PHPの日時処理、業務でお困りではありませんか？

本記事で紹介した DateTimeImmutable クラスの使い方をはじめ、日時関連のロジックやデータベースとの連携で「これで合ってるのかな…？」と迷うことはありませんか？

表示期間の制御、日時比較・変換、MySQLとの連携など、実務レベルでの実装・調整をサポートしております。お気軽にご相談ください。