PHP easter_date函数2037年后返回异常问题咨询

原因分析 #

1. easter_date()函数的32位时间戳限制：PHP 8.3之前的easter_date()底层基于32位Unix时间戳实现，而32位时间戳的最大值对应2038年1月19日03:14:07。2038年及之后的复活节日期（比如2038年复活节是4月3日）会超过这个时间戳上限，导致时间戳溢出。
2. 不同环境的溢出表现差异：
   • Windows系统（如XAMPP）中，easter_date()遇到溢出会返回false，后续调用date()处理false会触发错误，导致输出中断。
   • 部分在线环境会将溢出的无效时间戳默认解析为Unix纪元起始点（1970年1月1日），因此返回这个错误日期。

解决方法 #

方法1：升级到PHP 8.3及以上版本 #

PHP 8.3对easter_date()进行了重构，不再依赖32位时间戳，支持的年份范围扩展到1-9999年，直接解决时间戳溢出问题，升级后原代码即可正常运行。

方法2：使用easter_days()替代计算（无需升级PHP） #

easter_days()函数返回指定年份复活节距离3月21日的天数，通过这个值可以手动计算复活节日期，完全避开时间戳限制。修改后的代码示例：

$year = 2025;

while ($year <= 2050) 
{
    // 获取复活节距离3月21日的天数
    $daysOffset = easter_days($year);
    // 计算复活节日期
    $easterDate = strtotime("{$year}-03-21 +{$daysOffset} days");
    
    echo date('Y', $easterDate), " ";
    echo date('d', $easterDate), " ";
    echo date('F', $easterDate), "<br>";

    $year++;
}

注：64位PHP环境下，strtotime()支持更大的时间范围，Windows 11 64位搭配64位PHP时，这个方法可支持到9999年。

方法3：自定义复活节计算函数 #

如果需要兼容极端场景，可以实现Gauss复活节算法，示例代码：

function calculateEaster($year) {
    $a = $year % 19;
    $b = intdiv($year, 100);
    $c = $year % 100;
    $d = intdiv($b, 4);
    $e = $b % 4;
    $f = intdiv($b + 8, 25);
    $g = intdiv($b - $f + 1, 3);
    $h = (19 * $a + $b - $d - $g + 15) % 30;
    $i = intdiv($c, 4);
    $k = $c % 4;
    $l = (32 + 2 * $e + 2 * $i - $h - $k) % 7;
    $m = intdiv($a + 11 * $h + 22 * $l, 451);
    $month = intdiv($h + $l - 7 * $m + 114, 31);
    $day = (($h + $l - 7 * $m + 114) % 31) + 1;
    
    return date_create("{$year}-{$month}-{$day}");
}

// 使用示例
$year = 2025;
while ($year <= 2050) {
    $easter = calculateEaster($year);
    echo $easter->format('Y d F'), "<br>";
    $year++;
}

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