PHP date_diff() 函数

语法

DateInterval|false date_diff ( DateTimeInterface $base , DateTimeInterface $target [, bool $absolute = false ] )

参数说明

返回值

• DateInterval 对象 - 包含时间差信息
• false - 计算失败时返回

DateInterval 对象属性

示例代码

示例 1：基本用法 - 计算日期差

<?php
// 创建两个DateTime对象
$date1 = date_create('2024-03-15');
$date2 = date_create('2024-06-30');

// 计算差异
$interval = date_diff($date1, $date2);

if ($interval !== false) {
    echo "日期差异: " . $interval->format('%R%a 天') . "<br>";
    echo "详细差异: " . $interval->format('%y 年 %m 月 %d 天') . "<br>";
    echo "月份差: " . $interval->m . " 个月<br>";
    echo "总天数: " . $interval->days . " 天";
}
/*
输出：
日期差异: +107 天
详细差异: 0 年 3 月 15 天
月份差: 3 个月
总天数: 107 天
*/
?>

示例 2：计算年龄

<?php
// 计算年龄的实用函数
function calculateAge($birthDate, $currentDate = null) {
    if ($currentDate === null) {
        $currentDate = date_create();
    } else {
        $currentDate = date_create($currentDate);
    }

    $birthDate = date_create($birthDate);
    $interval = date_diff($birthDate, $currentDate);

    return [
        'years' => $interval->y,
        'months' => $interval->m,
        'days' => $interval->d,
        'total_days' => $interval->days,
        'formatted' => $interval->format('%y 岁 %m 个月 %d 天'),
    ];
}

// 测试计算年龄
$birthDate = '1990-06-15';
$currentDate = '2024-03-15';

$age = calculateAge($birthDate, $currentDate);

echo "出生日期: {$birthDate}<br>";
echo "当前日期: {$currentDate}<br>";
echo "年龄: {$age['formatted']}<br>";
echo "总天数: {$age['total_days']} 天<br>";
echo "详细: {$age['years']} 岁, {$age['months']} 个月, {$age['days']} 天";

/*
输出：
出生日期: 1990-06-15
当前日期: 2024-03-15
年龄: 33 岁 9 个月 0 天
总天数: 12336 天
详细: 33 岁, 9 个月, 0 天
*/
?>

示例 3：计算项目持续时间

<?php
// 项目开始和结束时间
$startDate = date_create('2024-01-01 09:00:00');
$endDate = date_create('2024-12-31 17:30:00');

// 计算项目持续时间
$duration = date_diff($startDate, $endDate);

echo "项目开始: " . $startDate->format('Y-m-d H:i:s') . "<br>";
echo "项目结束: " . $endDate->format('Y-m-d H:i:s') . "<br>";
echo "项目持续时间:<br>";

// 使用format方法格式化输出
$formats = [
    '总天数' => '%a 天',
    '年月日' => '%y 年 %m 月 %d 天',
    '时分秒' => '%h 小时 %i 分钟 %s 秒',
    '全部' => '%y 年 %m 月 %d 天 %h 小时 %i 分钟 %s 秒',
];

foreach ($formats as $label => $format) {
    echo "{$label}: " . $duration->format($format) . "<br>";
}

// 计算工作日（假设周末休息）
$totalDays = $duration->days;
$workDays = 0;

// 复制开始日期
$current = clone $startDate;

for ($i = 0; $i <= $totalDays; $i++) {
    $dayOfWeek = $current->format('N'); // 1-7 (1=Monday, 7=Sunday)
    if ($dayOfWeek <= 5) { // 周一到周五
        $workDays++;
    }
    $current->modify('+1 day');
}

echo "工作日数: {$workDays} 天（假设周末休息）<br>";
echo "周末天数: " . ($totalDays - $workDays) . " 天";
?>

示例 4：使用绝对差值

<?php
// 演示绝对差值参数的使用
$date1 = date_create('2024-06-30');
$date2 = date_create('2024-03-15');

// 不使用绝对差值（默认）
$interval1 = date_diff($date1, $date2);
echo "默认（不绝对）: " . $interval1->format('%R%a 天') . "<br>";
echo "invert值: " . $interval1->invert . "<br>";

// 使用绝对差值
$interval2 = date_diff($date1, $date2, true);
echo "绝对差值: " . $interval2->format('%R%a 天') . "<br>";
echo "invert值: " . $interval2->invert . "<br>";

// 验证绝对差值的效果
$date3 = date_create('2024-01-01');
$date4 = date_create('2024-12-31');

$diff1 = date_diff($date3, $date4);
$diff2 = date_diff($date4, $date3);

echo "<br>比较两个相反的顺序:<br>";
echo "date3 -> date4: " . $diff1->format('%R%a 天') . " (invert: {$diff1->invert})<br>";
echo "date4 -> date3: " . $diff2->format('%R%a 天') . " (invert: {$diff2->invert})<br>";

// 使用绝对差值
$diff3 = date_diff($date3, $date4, true);
$diff4 = date_diff($date4, $date3, true);
echo "使用绝对差值:<br>";
echo "date3 -> date4 (绝对): " . $diff3->format('%R%a 天') . " (invert: {$diff3->invert})<br>";
echo "date4 -> date3 (绝对): " . $diff4->format('%R%a 天') . " (invert: {$diff4->invert})<br>";
?>

示例 5：倒计时功能

<?php
// 倒计时功能实现
function countdownTimer($targetDateTime) {
    $now = new DateTime();
    $target = new DateTime($targetDateTime);

    if ($target <= $now) {
        return "时间已过！";
    }

    $interval = date_diff($now, $target);

    $parts = [];
    if ($interval->y > 0) $parts[] = $interval->y . '年';
    if ($interval->m > 0) $parts[] = $interval->m . '个月';
    if ($interval->d > 0) $parts[] = $interval->d . '天';
    if ($interval->h > 0) $parts[] = $interval->h . '小时';
    if ($interval->i > 0) $parts[] = $interval->i . '分钟';
    if ($interval->s > 0) $parts[] = $interval->s . '秒';

    $formatted = implode(' ', $parts);
    $totalSeconds = $interval->days * 86400 + $interval->h * 3600 + $interval->i * 60 + $interval->s;

    return [
        'formatted' => $formatted,
        'total_seconds' => $totalSeconds,
        'days' => $interval->days,
        'hours' => $interval->h,
        'minutes' => $interval->i,
        'seconds' => $interval->s,
        'is_future' => true,
    ];
}

// 测试倒计时
$events = [
    '新年' => '2025-01-01 00:00:00',
    '圣诞节' => '2024-12-25 00:00:00',
    '生日' => '2024-06-15 00:00:00',
    '会议' => '2024-03-20 14:30:00',
];

echo "倒计时列表:<br><br>";
foreach ($events as $event => $datetime) {
    $countdown = countdownTimer($datetime);

    if (is_string($countdown)) {
        echo "{$event}: {$countdown}<br>";
    } else {
        echo "{$event} ({$datetime}):<br>";
        echo "- 剩余: {$countdown['formatted']}<br>";
        echo "- 总秒数: {$countdown['total_seconds']}<br>";
        echo "- 天数: {$countdown['days']}<br>";
        echo "<br>";
    }
}
?>

DateInterval::format() 格式化字符

注意事项

常见问题

<?php
$date1 = date_create('2024-03-15 08:00:00');
$date2 = date_create('2024-03-15 20:30:00');
$interval = date_diff($date1, $date2);

// 方法1：使用format
$hours1 = $interval->format('%h');
echo "小时数（只算小时部分）: {$hours1}<br>";

// 方法2：计算总小时数
$totalHours = $interval->days * 24 + $interval->h + $interval->i/60;
echo "总小时数: " . round($totalHours, 2) . " 小时";
?>

<?php
// date_diff创建的DateInterval有days属性
$date1 = date_create('2024-01-01');
$date2 = date_create('2024-12-31');
$interval = date_diff($date1, $date2);
echo "days属性存在: " . ($interval->days ?? '不存在') . "<br>";

// 直接创建的DateInterval没有days属性
$interval2 = new DateInterval('P10D');
echo "直接创建的days属性: " . (isset($interval2->days) ? $interval2->days : '不存在');
?>

性能考虑

<?php
// 大量日期差计算时，考虑性能优化
function benchmarkDateDiff($iterations = 10000) {
    $dates1 = [];
    $dates2 = [];

    // 生成测试数据
    for ($i = 0; $i < $iterations; $i++) {
        $dates1[] = new DateTime('2024-01-01');
        $dates2[] = new DateTime('2024-12-31');
    }

    // 方法1：使用date_diff
    $start1 = microtime(true);
    for ($i = 0; $i < $iterations; $i++) {
        $interval = date_diff($dates1[$i], $dates2[$i]);
        $days = $interval->days;
    }
    $time1 = microtime(true) - $start1;

    // 方法2：使用时间戳计算
    $start2 = microtime(true);
    for ($i = 0; $i < $iterations; $i++) {
        $days = ($dates2[$i]->getTimestamp() - $dates1[$i]->getTimestamp()) / 86400;
    }
    $time2 = microtime(true) - $start2;

    echo "date_diff(): " . number_format($time1, 6) . " 秒<br>";
    echo "时间戳计算: " . number_format($time2, 6) . " 秒<br>";
    echo "性能差异: " . number_format(($time1 - $time2) * 1000, 3) . " 毫秒";
}

benchmarkDateDiff(10000);
?>

相关函数