PHP日期时长计算错误排查：月份计算多出天数问题

问题根源 #

你的代码存在两个核心问题：

1. 多余的日期偏移：代码中执行了$endDateTime->modify('+1 day');，这会将结束日期强制往后推一天，直接导致计算出的间隔比实际多了一天。
2. 日期解析歧义：直接使用new DateTime($startDate)和new DateTime($endDate)时，PHP会根据系统区域设置自动解析日期格式。如果你的日期是日-月-年（如01-03-2024代表3月1日），DateTime可能会错误地将其解析为月-日-年（即1月3日），这会导致整个间隔计算完全偏离预期。

修复后的基础版代码 #

function getDuration($startDate, $endDate)
{
    if (empty($startDate) || empty($endDate)) {
        return '';
    }

    // 明确指定日期格式为日-月-年，彻底避免解析歧义
    $startDateTime = DateTime::createFromFormat('d-m-Y', $startDate);
    $endDateTime = DateTime::createFromFormat('d-m-Y', $endDate);

    // 移除多余的+1天操作，还原真实日期间隔
    $interval = $startDateTime->diff($endDateTime);

    $duration = '';

    if ($years = $interval->y) {
        $duration .= "$years year" . ($years > 1 ? 's' : '') . ', ';
    }

    if ($months = $interval->m) {
        $duration .= "$months month" . ($months > 1 ? 's' : '') . ', ';
    }

    if ($days = $interval->d) {
        $duration .= "$days day" . ($days > 1 ? 's' : '');
    }

    return rtrim($duration, ', ');
}

测试验证 #

对于测试案例开始日期01-03-2024（3月1日）和结束日期31-03-2024（3月31日），修复后的基础版代码会返回30 days，这是两个日期之间的实际天数差。

适配「整月认知」的增强版代码 #

如果你的需求是将「当月1日到当月最后一天」视为1个月而非天数，可以添加边界判断逻辑：

function getDuration($startDate, $endDate)
{
    if (empty($startDate) || empty($endDate)) {
        return '';
    }

    $startDateTime = DateTime::createFromFormat('d-m-Y', $startDate);
    $endDateTime = DateTime::createFromFormat('d-m-Y', $endDate);

    // 处理当月1日到当月最后一天的特殊场景，返回"1 month"
    $isStartOfMonth = $startDateTime->format('d') === '01';
    $isEndOfMonth = $endDateTime->format('t') === $endDateTime->format('d');
    if ($isStartOfMonth && $isEndOfMonth && $startDateTime->format('Ym') === $endDateTime->format('Ym')) {
        return '1 month';
    }

    $interval = $startDateTime->diff($endDateTime);

    $duration = '';

    if ($years = $interval->y) {
        $duration .= "$years year" . ($years > 1 ? 's' : '') . ', ';
    }

    if ($months = $interval->m) {
        $duration .= "$months month" . ($months > 1 ? 's' : '') . ', ';
    }

    if ($days = $interval->d) {
        $duration .= "$days day" . ($days > 1 ? 's' : '');
    }

    return rtrim($duration, ', ');
}

这段代码会将01-03-2024到31-03-2024的结果返回为1 month，符合日常认知中的「整月」定义。

内容的提问来源于stack exchange，提问作者khn Rzk