初心者向けにPHP の相対日時の計算（strtotime, DateInterval）を解説する記事
新人
「PHPで相対的な日時を計算する方法ってありますか？」
先輩
「はい、PHPには相対日時を扱うための便利な関数がありますよ。今回は、その中でも特に便利なstrtotimeとDateIntervalを紹介します。」
新人
「それは便利ですね！具体的にはどのように使うんですか？」
先輩
「それでは、strtotimeの使い方を中心に説明しますね。」
1. 相対日時の計算とは？
相対日時とは、過去や未来の日時を指定する方法のことです。例えば、「3日前」や「1ヶ月後」のような指定を使うことができます。このような日時の計算は、プログラムで日付を扱う際に非常に役立ちます。
PHPでは、strtotime関数を使うことで、こういった相対的な日時を簡単に計算することができます。
2. strtotime 関数の使い方と基本的な使い方
strtotime関数は、文字列として記述された相対的な日時を、UNIXタイムスタンプ（1970年1月1日からの秒数）に変換します。これを利用することで、現在の日時を基準にして日時を簡単に計算できます。
例えば、現在から1週間後の日付を取得する場合、次のように記述できます。
<?php
$nextWeek = strtotime("+1 week");
echo date("Y-m-d", $nextWeek);
?>
上記のコードは、現在から1週間後の日付を計算して、"YYYY-MM-DD" 形式で表示します。このように、strtotimeを使うことで、簡単に相対的な日時を計算できます。
また、strtotimeは、さまざまな形式の相対日時に対応しています。例えば、「明日」や「来週の月曜日」なども指定することができます。
<?php
$tomorrow = strtotime("tomorrow");
$nextMonday = strtotime("next monday");
echo "明日の日付: " . date("Y-m-d", $tomorrow) . "\n";
echo "次の月曜日の日付: " . date("Y-m-d", $nextMonday) . "\n";
?>
このように、strtotime関数を使うことで、簡単に様々な相対日時を計算できます。
3. DateInterval クラスの使い方
DateIntervalクラスは、日時の加減を表現するためのクラスです。例えば、1ヶ月後や3日後といった日付の加算・減算をするために使います。このクラスを使うことで、より細かい日時の操作が可能になります。
DateIntervalクラスを使う場合は、まずnew DateInterval()でインスタンスを作成します。そして、加算や減算を行いたい期間を指定します。期間の指定は、P（期間）、Y（年）、M（月）、D（日）などを使います。
例えば、1ヶ月後の日時を取得する場合は以下のように書きます。
<?php
$interval = new DateInterval('P1M'); // 1ヶ月後
$now = new DateTime();
$now->add($interval);
echo $now->format('Y-m-d');
?>
このコードでは、現在の日付に1ヶ月を加算して、その結果を表示します。DateIntervalを使うことで、より柔軟に日付の加算・減算ができることがわかります。
また、DateIntervalは減算にも使えます。例えば、10日間を減算する場合、次のように記述します。
<?php
$interval = new DateInterval('P10D'); // 10日前
$now = new DateTime();
$now->sub($interval);
echo $now->format('Y-m-d');
?>
上記のコードでは、現在の日付から10日間を減算して、その結果を表示します。このように、DateIntervalを使うことで、日付の加算・減算を簡単に行うことができます。
4. 日付の加算・減算（相対日時の計算）
相対的な日時の計算は、日付を加算・減算する際に非常に重要です。strtotime関数とDateIntervalクラスを使いこなすことで、より柔軟な日時の計算が可能になります。
日付の加算・減算にはいくつかの方法がありますが、strtotime関数を使うときの注意点は、時間を指定することができる点です。たとえば、「3時間後」や「2週間前」といった指定が可能です。
例えば、現在から3時間後を計算する場合、以下のように書きます。
<?php
$threeHoursLater = strtotime("+3 hours");
echo date("Y-m-d H:i:s", $threeHoursLater);
?>
このように、strtotimeを使うことで、時間単位での計算も簡単にできます。
一方で、DateIntervalを使うことで、年月日の加算・減算だけでなく、時間や分、秒まで細かい単位での操作もできます。例えば、1時間と30分後を計算する場合は、次のように記述します。
<?php
$interval = new DateInterval('PT1H30M'); // 1時間30分後
$now = new DateTime();
$now->add($interval);
echo $now->format('Y-m-d H:i:s');
?>
このコードでは、現在の日時に1時間30分を加算して、その結果を表示します。DateIntervalは非常に強力なクラスで、細かい単位での加算や減算が可能です。
5. strtotime 関数と DateInterval クラスを使った組み合わせ例
strtotimeとDateIntervalを組み合わせると、さらに便利に日付を操作することができます。例えば、現在の日付から1週間後の金曜日の日付を計算する場合、次のように書きます。
<?php
$nextFriday = strtotime("next friday +1 week");
echo date("Y-m-d", $nextFriday);
?>
ここでは、strtotimeで「次の金曜日」からさらに1週間後の日付を計算しています。このように、strtotimeを使うことで、柔軟に日付を計算することができます。
また、DateIntervalを使うと、より正確に計算できます。例えば、1ヶ月後の金曜日を計算する場合、次のように記述します。
<?php
$now = new DateTime();
$interval = new DateInterval('P1M'); // 1ヶ月後
$now->add($interval);
$nextFriday = $now->modify('next friday');
echo $now->format('Y-m-d');
?>
このコードでは、まず1ヶ月後の日付を計算し、その後、その月の次の金曜日の日付を計算しています。modifyメソッドを使うことで、特定の日付（この場合は金曜日）を簡単に取得できます。
このように、strtotimeとDateIntervalをうまく組み合わせることで、非常に柔軟に日時を扱うことができます。
6. よく使う相対日時の計算例（今から何日後・何週間前など）
PHPでよく使う相対日時の計算には、いくつかのパターンがあります。以下に、日数や週数を基準にしたよく使う例をいくつか紹介します。
例1: 3日後の日時
現在から3日後の日付を計算する場合、strtotimeを使って簡単に取得できます。
<?php
$threeDaysLater = strtotime("+3 days");
echo date("Y-m-d", $threeDaysLater);
?>
このコードは、現在の日付から3日後を計算し、"YYYY-MM-DD" 形式で表示します。
例2: 2週間前の日時
現在から2週間前の日付を計算する場合、次のように記述します。
<?php
$twoWeeksAgo = strtotime("-2 weeks");
echo date("Y-m-d", $twoWeeksAgo);
?>
上記のコードは、現在から2週間前の日付を計算して、表示します。このように、strtotimeを使うと、非常に簡単に過去や未来の日付を計算できます。
例3: 1ヶ月後の日付
1ヶ月後の日付を計算する場合、strtotimeを使って次のように記述します。
<?php
$oneMonthLater = strtotime("+1 month");
echo date("Y-m-d", $oneMonthLater);
?>
このコードでは、1ヶ月後の日付を計算して表示します。このように、相対日時を計算することで、柔軟に日付を操作できます。
7. PHP で日付計算をする際のベストプラクティス
PHPで日付計算を行う際に気をつけるべきベストプラクティスをいくつか紹介します。これらを意識することで、コードの可読性やメンテナンス性を高めることができます。
1. DateTimeとDateIntervalを使う場合、タイムゾーンを意識する
日付を扱う場合、タイムゾーンに注意することが重要です。デフォルトでは、PHPはシステムのタイムゾーンを使用しますが、異なるタイムゾーンを指定することもできます。
<?php
$date = new DateTime("now", new DateTimeZone("Asia/Tokyo"));
echo $date->format("Y-m-d H:i:s");
?>
上記のコードでは、東京のタイムゾーンを指定して現在日時を表示しています。これにより、異なるタイムゾーンでの日時計算を簡単に行うことができます。
2. strtotimeで相対日時を指定する際に、文字列の形式に気をつける
strtotime関数を使用する際には、文字列の書き方に気をつけましょう。例えば、「next Monday」と「monday next」では異なる結果が返る場合があります。
<?php
$nextMonday = strtotime("next Monday");
echo date("Y-m-d", $nextMonday);
?>
このように、strtotimeでは柔軟な表現が可能ですが、予期しない結果が返ってくることがあるため、仕様を理解して使うことが大切です。
8. 実際の開発で役立つ相対日時の計算（イベントの期限計算など）
相対日時の計算は、実際の開発においても非常に役立ちます。例えば、イベントの期限計算や、定期的なタスクのスケジュールを計算する際などです。
例1: イベントの期限計算
あるイベントが10日後に開催される場合、その期限を計算するには、次のように記述します。
<?php
$eventDeadline = strtotime("+10 days");
echo "イベントの期限: " . date("Y-m-d", $eventDeadline);
?>
このコードは、現在から10日後の日付を計算して、イベントの期限を表示します。strtotimeを使うことで、簡単にイベントの期限を動的に計算することができます。
例2: 定期的なタスクのスケジュール計算
定期的に行われるタスク（例えば、毎月の支払い処理など）のスケジュールを計算する際にも、相対日時を使います。例えば、次回の支払い日は「今月の月末」とする場合、次のように記述します。
<?php
$nextMonthEnd = strtotime("last day of next month");
echo "次回の支払い日: " . date("Y-m-d", $nextMonthEnd);
?>
上記のコードでは、次の月の月末の日付を計算しています。このように、相対日時を使うと、定期的なスケジュール計算を簡単に行うことができます。
相対日時の計算は、開発の中で非常に便利な技術です。strtotimeとDateIntervalを使いこなすことで、日時の加減算やスケジュール計算が簡単にできるようになります。
まとめ
PHPにおける相対日時の計算は、日付操作を柔軟かつ効率的に行うために欠かせない技術です。本記事では、strtotime関数とDateIntervalクラスを中心に、実際のコード例を交えて解説しました。strtotimeは、自然言語のような文字列から簡単に未来や過去の日付を取得できる便利な関数であり、「+3 days」「next friday」など人間にわかりやすい形式で指定できるのが特徴です。
一方で、DateIntervalは日付や時間の加算・減算をオブジェクト指向で管理することができ、DateTimeと組み合わせることでより厳密かつ細かな制御が可能になります。時間単位での計算やタイムゾーンの考慮、1ヶ月後の特定曜日の取得など、実際の開発に役立つ多くの応用例も紹介しました。
特にイベント管理や定期処理のスケジューリング、ユーザー登録後の有効期限計算、リマインダー通知など、現実のアプリケーション開発において相対日時の概念は幅広く活用されています。こうした日付計算は、コードの保守性や再利用性にも関わるため、ベストプラクティスとしてDateTime、DateInterval、strtotimeを正しく使い分けることが重要です。
実務では、strtotimeで手軽に処理する場面も多くありますが、長期的な管理や国際化対応などを考慮すると、DateTimeとDateIntervalによる厳密な処理が必要となるケースも増えてきます。そのため、どちらの手法も習得しておくことがPHPエンジニアにとっての強みになります。
最後に、strtotimeの相対日時指定は一見便利なようでいて、表現によっては誤解やバグの元になることもあります。たとえば「monday next」など曖昧な表現には注意が必要です。確実な計算が求められる場面では、DateTimeとDateIntervalによる明示的な日時処理を選ぶのが安全です。
実用的な応用例：1ヶ月後の金曜日の通知スケジュール
以下は、1ヶ月後の金曜日にリマインダー通知を送るようなケースの例です：
<?php
$now = new DateTime();
$interval = new DateInterval('P1M');
$now->add($interval);
$reminderDate = $now->modify('next friday');
echo "通知日: " . $reminderDate->format('Y-m-d');
?>
このように、柔軟かつ正確にスケジュールを組むことができる点が、DateIntervalとDateTimeの大きなメリットです。
新人
「strtotimeって、自然な言葉みたいに日付が指定できてすごく便利でした！」
先輩
「そうだね。ただし、柔軟な分だけ、書き方によっては思った通りに動かないこともあるから気をつけよう。」
新人
「なるほど……確実に処理したいときはDateIntervalとDateTimeを使ったほうが良さそうですね。」
先輩
「その通り。どちらも使いこなせると、イベントの期限管理や通知機能、タスクの自動化なんかも思い通りに実装できるよ。」
新人
「はい、これからは日付を扱う場面でも安心してコードが書けそうです！」
この記事を読んだ人からの質問
