PHP DateTime diffによる日付差分計算の基本と活用法を解説

<?php
// 日付文字列からDateTimeオブジェクトを生成するサンプルコード
$dateStr = '2023-10-01 10:00:00';
$dateTimeObj = new DateTime($dateStr);
echo $dateTimeObj->format('Y-m-d H:i:s'); // 出力例: 2023-10-01 10:00:00
?>

2023-10-01 10:00:00

<?php
// タイムゾーンを指定してDateTimeオブジェクトを生成するサンプルコード
$dateStr = '2023-10-01 10:00:00';
$timezone = new DateTimeZone('Asia/Tokyo');
$dateTimeObj = new DateTime($dateStr, $timezone);
echo $dateTimeObj->format('Y-m-d H:i:s'); // 出力例: 2023-10-01 10:00:00
?>

2023-10-01 10:00:00

<?php
// 2つの日付の差分を計算するサンプルコード
$dateStart = new DateTime('2023-10-01');
$dateEnd = new DateTime('2023-10-10');
$interval = $dateStart->diff($dateEnd);
echo '差分: ' . $interval->days . '日'; // 出力例: 差分: 9日
?>

差分: 9日

<?php
// DateIntervalオブジェクトのプロパティを使用して詳細な差分を表示するサンプルコード
$dateStart = new DateTime('2023-10-01 08:00:00');
$dateEnd = new DateTime('2023-10-03 10:30:00');
$interval = $dateStart->diff($dateEnd);
echo '日数: ' . $interval->d . "日\n";   // 出力例: 2日
echo '時刻: ' . $interval->h . "時間\n";   // 出力例: 2時間
echo '分数: ' . $interval->i . "分";        // 出力例: 30分
?>

日数: 2日
時刻: 2時間
分数: 30分

<?php
// サンプル: 2つの日付の差分計算
$dateBegin = new DateTime('2023-10-01 08:00:00'); // 開始日
$dateFinish = new DateTime('2023-10-05 12:45:00'); // 終了日
// diffメソッドで差分を計算
$diffInterval = $dateBegin->diff($dateFinish);
// 結果を各プロパティから取得して表示
echo '年: ' . $diffInterval->y . "\n";   // 年数の差分
echo '月: ' . $diffInterval->m . "\n";   // 月数の差分
echo '日: ' . $diffInterval->d . "\n";   // 日数の差分
echo '時間: ' . $diffInterval->h . "\n"; // 時間の差分
echo '分: ' . $diffInterval->i . "\n";   // 分数の差分
?>

年: 0
月: 0
日: 4
時間: 4
分: 45

<?php
// DateIntervalのformat()を利用した差分のフォーマット表示
$dateBegin = new DateTime('2023-10-01 08:00:00');
$dateFinish = new DateTime('2023-10-05 12:45:00');
$diffInterval = $dateBegin->diff($dateFinish);
// %Rは符号、%aは全体の日数を表す
echo $diffInterval->format('%R%a日 %H時間 %I分');
?>

+4日 04時間 45分

<?php
// 日付差分の各部の値を取得して合計分数を計算するサンプルコード
$dateStart = new DateTime('2023-10-01 08:00:00');
$dateEnd = new DateTime('2023-10-03 09:30:00');
$interval = $dateStart->diff($dateEnd);
$days   = $interval->d; // 日数
$hours  = $interval->h; // 時間
$minutes = $interval->i; // 分
// 合計分数の計算
$totalMinutes = $days * 24 * 60 + $hours * 60 + $minutes;
echo "合計分数: " . $totalMinutes;
?>

合計分数: 3090

<?php
// DateIntervalのformat()を用いて、カスタムフォーマットで差分を表示するサンプルコード
$dateBegin = new DateTime('2023-10-01 08:00:00');
$dateFinish = new DateTime('2023-10-03 09:30:00');
$interval = $dateBegin->diff($dateFinish);
// カスタムフォーマットで結果を表示
$formattedOutput = $interval->format('%d日 %H時間 %I分');
echo $formattedOutput;
?>

02日 01時間 30分

<?php
// try-catchを利用した不正な日付入力の例外処理のサンプルコード
try {
    $invalidDate = 'invalid-date';
    $dateTimeObj = new DateTime($invalidDate);
    echo $dateTimeObj->format('Y-m-d H:i:s');
} catch (Exception $e) {
    echo "日付の生成に失敗しました: " . $e->getMessage();
}
?>

日付の生成に失敗しました: DateTime::__construct(): Failed to parse time string (invalid-date) at position 0 (i): The timezone could not be found in the database

<?php
// 現在のデフォルトタイムゾーンを確認するサンプルコード
$currentTZ = date_default_timezone_get();
echo "現在のタイムゾーン: " . $currentTZ;
?>

現在のタイムゾーン: Asia/Tokyo

<?php
// アプリケーション全体でタイムゾーンを設定するサンプルコード
date_default_timezone_set('Asia/Tokyo');
$dateTimeObj = new DateTime('2023-10-01 10:00:00');
echo $dateTimeObj->format('Y-m-d H:i:s'); // 出力例: 2023-10-01 10:00:00
?>

2023-10-01 10:00:00