［PHP］date_diff()関数の使い方を徹底解説！日付の差分を簡単に計算しよう

こんにちは！今回は、PHPでよく使用されるdate_diff()関数について詳しく解説していきます。日付の差分を計算する際に非常に便利なこの関数、ぜひマスターしていきましょう！

📅 date_diff()関数とは？
🔰 基本的な使い方
💡 実践的な使用例
1. 1. 年齢計算
2. 2. 期間の詳細表示
🔍 便利なフォーマット指定子
⚠️ 注意点とエラー処理
🎯 活用シーン
📝 応用例：残り時間のカウントダウン
まとめ

📅 date_diff()関数とは？

date_diff()は、2つの日付の差分を計算するPHPの関数です。年、月、日、時間など、様々な単位で差分を取得できる便利な関数です。

🔰 基本的な使い方

まずは基本的な使い方から見ていきましょう。

$date1 = new DateTime('2023-01-01');
$date2 = new DateTime('2023-12-31');

$interval = $date1->diff($date2);

echo $interval->days; // 364日と表示されます

💡 実践的な使用例

1. 年齢計算

function calculateAge($birthdate) {
    $birth = new DateTime($birthdate);
    $today = new DateTime('today');
    $age = $birth->diff($today);
    return $age->y;
}

// 使用例
$age = calculateAge('1990-05-15');
echo "年齢は{$age}歳です";

2. 期間の詳細表示

$date1 = new DateTime('2023-01-01');
$date2 = new DateTime('2024-03-15');

$interval = $date1->diff($date2);
echo $interval->format('%y年 %mヶ月 %d日');

🔍 便利なフォーマット指定子

指定子	説明
%y	年
%m	月
%d	日
%h	時間
%i	分
%s	秒
%R	符号（+/-）
%a	総日数

⚠️ 注意点とエラー処理

エラーが発生する可能性があるため、try-catch構文での対応をお勧めします。

try {
    $date1 = new DateTime('不正な日付');
    $date2 = new DateTime('2023-12-31');
    $interval = $date1->diff($date2);
} catch (Exception $e) {
    echo "エラーが発生しました: " . $e->getMessage();
}

🎯 活用シーン

会員の年齢計算
イベントまでのカウントダウン表示
契約期間の計算
作業時間の計算
期限切れの判定

📝 応用例：残り時間のカウントダウン

$target = new DateTime('2024-12-31');
$now = new DateTime();
$interval = $now->diff($target);

echo "新年まであと：\n";
echo $interval->format('%adays %h時間 %i分 %s秒');