PHP の DateTime クラスの基本的な使い方を完全ガイド！初心者向け解説
新人
「PHPで日付や時間を扱いたいのですが、どんな方法がありますか？」
先輩
「PHPでは DateTime クラスを使うことで、簡単に日付や時間を操作できます。」
新人
「DateTime クラスって何ですか？」
先輩
「それでは、基本から説明していきますね！」
1. DateTime クラスとは？
PHPの DateTime クラスは、日付や時間を扱うための組み込みクラスです。date() 関数よりも強力で、さまざまな操作が可能です。
例えば、現在の日付を取得するには以下のように書きます。
$now = new DateTime();
echo $now->format('Y-m-d H:i:s');
このコードを実行すると、現在の日付と時間が表示されます。
2. DateTime クラスを使うメリット
DateTime クラスを使うと、日付や時間の計算、フォーマットの変更、タイムゾーンの管理などが簡単にできます。
例えば、1日後の日付を取得する場合は以下のように書きます。
$tomorrow = new DateTime();
$tomorrow->modify('+1 day');
echo $tomorrow->format('Y-m-d H:i:s');
このように、簡単なコードで日付の計算ができます。
3. DateTime クラスの基本的な使い方（現在の日時を取得する、特定の日付を設定する）
PHP の DateTime クラスを使うと、現在の日付や時間を簡単に取得できます。また、特定の日付を設定してその日付に基づいた操作を行うこともできます。
まずは、現在の日付と時間を取得する方法を見てみましょう。次のコードを使うと、現在の日時が表示されます。
<?php
$date = new DateTime();
echo $date->format("Y-m-d H:i:s");
?>
出力結果（2025年3月2日 14:30:15 の場合）：
2025-03-02 14:30:15
次に、特定の日付を設定して表示する方法です。例えば、「2025年12月25日」の日時を設定して表示するには、次のコードを使います。
<?php
$date = new DateTime("2025-12-25");
echo $date->format("Y-m-d");
?>
出力結果：
2025-12-25
このように、DateTime クラスを使えば、簡単に現在の日時や特定の日付を操作することができます。
4. フォーマットを変更する方法
日付や時間を表示する際に、表示形式を変更することができます。これを行うには、format() メソッドを使用します。このメソッドに指定できるフォーマットは、さまざまな形式があります。
例えば、「2025年12月25日」を「月/日/年」の形式で表示したい場合、次のコードを使います。
<?php
$date = new DateTime("2025-12-25");
echo $date->format("m/d/Y");
?>
出力結果：
12/25/2025
このように、format() メソッドを使うことで、日付の表示形式を自由に変更できます。
また、時間を含めて「2025年12月25日 14:30」のように表示する場合も、同じく format() を使って次のように書けます。
<?php
$date = new DateTime("2025-12-25 14:30");
echo $date->format("Y-m-d H:i");
?>
出力結果：
2025-12-25 14:30
日付と時間の表示形式を変更することで、より分かりやすく、必要な形で情報を表示できます。
5. 日時の計算（加算・減算）
DateTime クラスでは、日時を加算・減算することも非常に簡単です。modify() メソッドを使用することで、指定した日数や時間を加算・減算できます。
例えば、現在の日時から1週間後の日付を求めるには、次のように記述します。
<?php
$date = new DateTime();
$date->modify("+1 week");
echo $date->format("Y-m-d H:i:s");
?>
出力結果（2025年3月2日から1週間後の場合）：
2025-03-09 14:30:15
逆に、1週間前の日付を求める場合は、次のように書きます。
<?php
$date = new DateTime();
$date->modify("-1 week");
echo $date->format("Y-m-d H:i:s");
?>
出力結果（2025年3月2日から1週間前の場合）：
2025-02-23 14:30:15
このように、modify() メソッドを使うと、簡単に日付や時間を加算・減算することができます。特定の日付や時間を変更したい場合にとても便利です。
6. タイムゾーンの設定方法
PHP の DateTime クラスでは、タイムゾーンを設定することができます。タイムゾーンは、異なる地域の時間を管理するために非常に重要です。DateTime クラスでタイムゾーンを設定する方法を見てみましょう。
まず、タイムゾーンを設定しないと、デフォルトのタイムゾーンが使用されます。デフォルトでは「UTC」が設定されています。特定のタイムゾーンを設定するには、setTimezone() メソッドを使用します。
次のコードでは、東京（Asia/Tokyo）のタイムゾーンを設定し、現在の日時を表示します。
<?php
$date = new DateTime();
$timezone = new DateTimeZone("Asia/Tokyo");
$date->setTimezone($timezone);
echo $date->format("Y-m-d H:i:s");
?>
出力結果（2025年3月2日、東京の場合）：
2025-03-02 14:30:15
このように、タイムゾーンを変更することで、異なる地域の時間を正確に管理することができます。
7. DateTime クラスを使う際の注意点（タイムゾーンの違いによる問題など）
タイムゾーンを設定しない場合、デフォルトのタイムゾーン（通常はUTC）が使用されます。この場合、ユーザーが別のタイムゾーンにいると、時間がずれて表示されることがあります。
たとえば、アメリカ東部時間（EST）を使用しているユーザーが、日本時間（JST）の日時を表示したい場合、タイムゾーンを適切に設定していないと、時間がずれる可能性があります。
そのため、タイムゾーンを明示的に設定することが重要です。特に、国際的なWebアプリケーションやサービスを開発する際は、タイムゾーンを意識して処理を行う必要があります。
次のコードでは、UTCタイムゾーンの日時と東京タイムゾーンの日時を比較してみましょう。
<?php
$timezone_utc = new DateTimeZone("UTC");
$timezone_tokyo = new DateTimeZone("Asia/Tokyo");
$utc_time = new DateTime("now", $timezone_utc);
$tokyo_time = new DateTime("now", $timezone_tokyo);
echo "UTC Time: " . $utc_time->format("Y-m-d H:i:s") . "<br>";
echo "Tokyo Time: " . $tokyo_time->format("Y-m-d H:i:s");
?>
出力結果：
UTC Time: 2025-03-02 06:30:15
Tokyo Time: 2025-03-02 15:30:15
このように、タイムゾーンによって時間がずれるため、使用するタイムゾーンを正しく設定することが大切です。
8. 実際の開発で役立つ応用例
DateTime クラスは、単に日付と時間を取得するだけでなく、実際の開発でも非常に役立つ機能を提供します。ここでは、実際の開発シーンでよく使われる応用例をいくつか紹介します。
① カウントダウンタイマーの作成
次の例では、カウントダウンタイマーを作成します。現在時刻と目標時刻（例えば、2025年12月31日23:59）を比較し、残り時間を表示します。
<?php
$now = new DateTime();
$target = new DateTime("2025-12-31 23:59");
$interval = $now->diff($target);
echo "残り時間: " . $interval->format('%R%a 日 %H 時間 %I 分 %S 秒');
?>
出力結果（2025年3月2日 14:30時点の場合）：
残り時間: +305 日 09 時間 29 分 45 秒
② ユーザーの誕生日から年齢を計算する
ユーザーの誕生日を基に、現在の年齢を計算する場合も DateTime クラスが便利です。
<?php
$birthdate = new DateTime("1990-05-15");
$now = new DateTime();
$age = $now->diff($birthdate);
echo "年齢: " . $age->y . "歳";
?>
出力結果（現在が2025年3月2日の場合）：
年齢: 34歳
③ 期限付きのタスクを表示する
期限が設定されたタスクを管理する際、期限までの日数を表示することができます。例えば、タスクの締切日が2025年4月1日で、現在の日付を使って締切までの日数を表示するコードを次のように書きます。
<?php
$due_date = new DateTime("2025-04-01");
$now = new DateTime();
$interval = $now->diff($due_date);
echo "締切まで: " . $interval->days . "日";
?>
出力結果（現在が2025年3月2日の場合）：
締切まで: 30日
このように、DateTime クラスを活用することで、さまざまな日付操作や計算が簡単に行えます。日付や時間を管理する際には、DateTime クラスが非常に有用です。
