［PHP］date_interval_create_from_date_string()関数完全解説！期間を簡単に扱おう

こんにちは！今回は、PHPで期間を扱う際に便利なdate_interval_create_from_date_string()関数について詳しく解説していきます。

📅 date_interval_create_from_date_string()とは？

この関数は、テキストによる期間の記述からDateIntervalオブジェクトを作成する関数です。
時間の加算や減算を簡単に行うことができます。

🔰 基本的な使い方

// 基本的な構文
$interval = date_interval_create_from_date_string('1 day');

💡 主な使用例

1. 基本的な期間指定

// 様々な期間指定
$oneDay = date_interval_create_from_date_string('1 day');
$twoWeeks = date_interval_create_from_date_string('2 weeks');
$threeMonths = date_interval_create_from_date_string('3 months');
$oneYear = date_interval_create_from_date_string('1 year');

2. DateTimeオブジェクトとの組み合わせ

$date = new DateTime('2024-01-15');

// 1週間後を取得
$interval = date_interval_create_from_date_string('1 week');
$date->add($interval);
echo $date->format('Y-m-d'); // 2024-01-22

// 2ヶ月前を取得
$interval = date_interval_create_from_date_string('2 months');
$date->sub($interval);
echo $date->format('Y-m-d');

📝 指定可能な期間形式

// 日数
$interval = date_interval_create_from_date_string('5 days');

// 週
$interval = date_interval_create_from_date_string('2 weeks');

// 月
$interval = date_interval_create_from_date_string('3 months');

// 年
$interval = date_interval_create_from_date_string('1 year');

// 時間
$interval = date_interval_create_from_date_string('6 hours');

// 分
$interval = date_interval_create_from_date_string('30 minutes');

// 秒
$interval = date_interval_create_from_date_string('45 seconds');

🎯 実践的な使用例

1. 期限切れの判定

function isExpired($startDate, $duration) {
    $date = new DateTime($startDate);
    $interval = date_interval_create_from_date_string($duration);
    $expiryDate = clone $date;
    $expiryDate->add($interval);

    return new DateTime() > $expiryDate;
}

// 使用例
$isExpired = isExpired('2024-01-01', '30 days');
echo $isExpired ? '期限切れです' : '有効です';

2. 営業日の計算

function addBusinessDays($date, $days) {
    $date = new DateTime($date);
    $interval = date_interval_create_from_date_string('1 day');

    while ($days > 0) {
        $date->add($interval);
        // 土日をスキップ
        if ($date->format('N') >= 6) continue;
        $days--;
    }

    return $date;
}

// 使用例
$nextBusinessDay = addBusinessDays('2024-01-15', 5);

3. 複合的な期間指定

$interval = date_interval_create_from_date_string('2 weeks 3 days 4 hours');
$date = new DateTime();
$date->add($interval);

⚠️ 注意点とエラー処理

try {
    // 不正な期間指定
    $interval = date_interval_create_from_date_string('invalid interval');
    if ($interval === false) {
        throw new Exception('不正な期間形式です');
    }
} catch (Exception $e) {
    echo "エラー: " . $e->getMessage();
}

💡 便利な使い方のTips

1. 定期的なイベントの日程計算

function getNextEvents($startDate, $interval, $count) {
    $dates = [];
    $date = new DateTime($startDate);
    $intervalObj = date_interval_create_from_date_string($interval);

    for ($i = 0; $i < $count; $i++) {
        $dates[] = clone $date;
        $date->add($intervalObj);
    }

    return $dates;
}

// 使用例
$events = getNextEvents('2024-01-01', '2 weeks', 5);

2. 期間の比較

function compareDurations($duration1, $duration2) {
    $interval1 = date_interval_create_from_date_string($duration1);
    $interval2 = date_interval_create_from_date_string($duration2);

    $date = new DateTime();
    $date1 = clone $date;
    $date2 = clone $date;

    $date1->add($interval1);
    $date2->add($interval2);

    return $date1 <=> $date2;
}

// 使用例
$result = compareDurations('2 weeks', '10 days');

まとめ

date_interval_create_from_date_string()は以下のような特徴があります：

• 直感的な期間指定が可能
• DateTimeオブジェクトとの相性が良い
• 様々な時間単位に対応
• 複合的な期間指定が可能

主な活用シーン：

• 期限切れの判定
• スケジュール計算
• 営業日の計算
• 定期的なイベントの日程管理