• Xでシェア
  • LINEでシェア
  • このエントリーをはてなブックマークに追加

PHP DateIntervalクラスの使い方

この記事のポイント

PHPで日時計算を行う際に欠かせないDateIntervalクラスについて、基本的な使い方から実践的な活用方法まで詳しく解説します。

  • 時間間隔や期間を表現するDateIntervalクラスの基本概念と構文
  • 日付の加算減算やタイマー機能など実際の開発で使える実用的なコード例
  • プロジェクトで活用できる具体的なサンプルとベストプラクティス

以下で詳細に説明していきますので、ぜひ最後まで読んで理解を深めてください。

目次

DateIntervalクラスとは?

DateIntervalクラスは、時間の間隔や期間を表現するためのクラスです。例えば「3日間」「2時間30分」「1年6か月」などの期間を扱えます。このクラスを使用することで、日付の加算や減算、2つの日付間の差を計算する処理が簡単に実装できます。

ISO 8601形式の期間表記に対応しており、P1Y2M3DT4H5M6Sのような標準的な形式で期間を指定できます。DateTimeクラスと組み合わせることで、カレンダー機能や予約システムなどさまざまなWebアプリケーションで活用されています。

【関連】
PHPをもっと詳しく学ぶならpaizaラーニング

基本構文

DateIntervalクラスの基本的な使い方として、コンストラクタで期間を指定する方法とcreateFromDateString()メソッドを使用する方法があります。ISO 8601形式では、Pで開始し、年月日は文字通り、時分秒はTの後に記述します。以下のコード例で具体的な使用方法を確認しましょう。

<?php // 1年2か月3日の期間を作成 $interval = new DateInterval('P1Y2M3D'); echo $interval->format('%y年%m月%d日'); ?>

出力結果

1年2月3日

※このページ内のコードの出力結果の一部で、実行した時刻により変動するものがあります。また、時刻はUTC形式で計算されるため、日本時間での計算結果と異なる場合があります

<?php // 4時間30分の期間を作成 $timeInterval = new DateInterval('PT4H30M'); echo $timeInterval->format('%h時間%i分'); ?>

出力結果

4時間30分
<?php // 文字列から期間を作成 $interval = DateInterval::createFromDateString('2 weeks'); $date = new DateTime(); $date->add($interval); echo $date->format('Y-m-d'); ?>

出力結果(例)

2025-08-28

実用例

ここからは、実際の開発現場でよく使用されるDateIntervalクラスの具体的なサンプルコードを紹介します。日付の操作から時間計算まで、さまざまな場面で活用できる実用的なコード例を8つのパターンに分けて解説します。

各コード例では、動物を使った分かりやすい出力結果を表示し、コードの動作を理解しやすくしています。

日付に期間を加算

現在の日付に指定した期間を加算する基本的な例です。イベントの開催日程やタスクの締切日設定などでよく使用されます。

<?php $today = new DateTime(); $interval = new DateInterval('P30D'); $futureDate = clone $today; $futureDate->add($interval); echo "今日: ネコの誕生日 " . $today->format('Y-m-d') . "\n"; echo "30日後: イヌの誕生日 " . $futureDate->format('Y-m-d'); ?>

出力結果(例)

今日: ネコの誕生日 2025-08-14
30日後: イヌの誕生日 2025-09-13

年月日を個別に操作

DateIntervalクラスのプロパティを直接設定して、年月日を個別に操作する例を示します。動的な期間設定に便利です。

<?php $date = new DateTime('2025-01-01'); $interval = new DateInterval('P0D'); $interval->y = 1; $interval->m = 6; $interval->d = 15; $date->add($interval); echo "ライオンの成長記録: " . $date->format('Y年m月d日'); ?>

出力結果

ライオンの成長記録: 2026年07月16日

時間差を計算

二つの日付間の差を計算し、その結果をDateIntervalオブジェクトとして取得する例です。経過時間の計算に活用できます。

<?php $start = new DateTime('2025-01-01 09:00:00'); $end = new DateTime('2025-01-01 17:30:00'); $diff = $start->diff($end); echo "パンダの勤務時間: " . $diff->format('%h時間%i分'); ?>

出力結果

パンダの勤務時間: 8時間30分

定期処理の間隔設定

定期的に実行される処理の間隔をDateIntervalクラスで管理する実用的な例です。バッチ処理やメンテナンス作業のスケジュール設定に適用できます。

<?php $lastRun = new DateTime('2025-01-01 12:00:00'); $interval = new DateInterval('PT6H'); $nextRun = clone $lastRun; $nextRun->add($interval); echo "コアラの餌やり時間: " . $nextRun->format('Y-m-d H:i:s'); ?>

出力結果

コアラの餌やり時間: 2025-01-01 18:00:00

営業日計算の実装

週末を除外した営業日の計算にDateIntervalクラスを活用する例です。ビジネスアプリケーションでの納期計算に役立ちます。

<?php $date = new DateTime('2025-01-01'); $daysToAdd = 5; for ($i = 0; $i < $daysToAdd; $i++) { $date->add(new DateInterval('P1D')); if ($date->format('N') >= 6) $i--; } echo "キリンの出荷予定日: " . $date->format('Y-m-d'); ?>

出力結果

キリンの出荷予定日: 2025-01-08

イベント日程の管理

複数のイベント日程を管理し、次回開催日を自動計算する例です。定期イベントやスケジュール管理システムで活用できます。

<?php $eventDate = new DateTime('2025-01-15'); $monthlyInterval = new DateInterval('P1M'); $nextEvent = clone $eventDate; $nextEvent->add($monthlyInterval); echo "ゾウの健康診断: " . $nextEvent->format('Y年m月d日'); ?>

出力結果

ゾウの健康診断: 2025年02月15日

データベース保存期間の設定

データの保存期限を設定し、期限切れデータの削除タイミングを計算する例です。ログ管理やバックアップシステムに応用できます。

<?php $created = new DateTime('2025-01-01'); $retention = new DateInterval('P90D'); $expireDate = clone $created; $expireDate->add($retention); echo "ウサギのデータ削除日: " . $expireDate->format('Y-m-d'); ?>

出力結果

ウサギのデータ削除日: 2025-04-01

年齢計算の実装

生年月日から現在の年齢を正確に計算する例です。会員管理システムや統計処理でよく使用される実用的な実装例です。

<?php $birthDate = new DateTime('2020-05-15'); $today = new DateTime(); $age = $birthDate->diff($today); echo "サルの年齢: " . $age->format('%y歳%m月'); ?>

出力結果(例)

サルの年齢: 5歳2月

まとめ

DateIntervalクラスは、時間の間隔や期間を扱うためのクラスであり、さまざまなWebアプリケーション開発で重要な役割を果たします。ISO8601形式に対応した標準的な記法により、直感的で保守性の高いコードを作成できます。基本的な日付計算から複雑なビジネスロジックまで、幅広い場面で活用可能な汎用性の高いツールです。

DateIntervalクラスの活躍する場面

  • 予約システムやカレンダー機能での日程管理と期間計算
  • バッチ処理や定期タスクのスケジュール設定と実行間隔制御
  • データ保存期限の管理とログファイルの自動削除処理

重要なポイント

  • ISO 8601形式を理解し適切な期間指定を行う基本スキル
  • DateTimeクラスとの組み合わせによる効率的な日時操作手法
  • 実際のプロジェクトで使用する際のエラーハンドリングと例外処理

DateIntervalクラスをマスターすることで、より高度で実用的なWebアプリケーションの開発が可能になります。今回紹介したサンプルコードを参考に、実際のプロジェクトでぜひ活用してください。継続的な学習により、さらなるスキル向上を目指しましょう。

レベルを更に上げたい方はpaizaプログラミングスキルチェックへ

  1. paizaラーニングトップ
  2. リファレンス
  3. PHPのリファレンス記事一覧
  4. PHP DateIntervalクラスの使い方