PHP IntlDateFormatter 时区与 DateTime 时区不一致怎么办

PHP 里最容易误判的一点是：DateTime 对象带着 Asia/Shanghai，并不代表 IntlDateFormatter 一定会按这个时区显示。IntlDateFormatter::format() 接收 DateTimeInterface 时，会忽略对象自身的时区，使用 formatter 创建时配置的时区。因此，同一个时间点出现相差八小时的结果，通常不是 ICU 随机出错，而是两层配置没有统一。

官方地址：https://www.php.net/manual/en/

区分时间点、对象时区与 formatter 时区

一个日期值至少包含三件事：时间点、输入时区和展示时区。DateTimeImmutable::setTimezone() 改的是展示方式，底层时间点不变；而 formatter 的 timezone 参数决定本次本地化输出采用哪个时区。下面这个关系图用同一个时间点表示两条配置路径。

排查时不要只打印 $date->getTimezone()，还要打印 $formatter->getTimeZoneId()，确认两者是否真的指向同一个 IANA 标识。

让 DateTime 和 IntlDateFormatter 共享 DateTimeZone

最稳妥的实现是把时区当成依赖注入到两个对象，而不是分别写字符串。这样修改业务地区时只改一个入口，也不会因为 PHP 默认时区或服务器配置不同而产生隐式偏移。

format(DateTimeInterface::ATOM), PHP_EOL;
echo $formatter->format($date), PHP_EOL;
echo $formatter->getTimeZoneId(), PHP_EOL;
?>

重点不是把两个输出做成完全相同的文字，而是让它们表达同一个本地时间。LONG、SHORT 负责本地化风格；如果只需要固定接口格式，直接使用 format(DateTimeInterface::ATOM) 往往更容易与数据库和日志对齐。

规范输入解析和 ICU 格式模式

如果输入本身带偏移量，例如 2026-09-14T01:30:00+00:00，PHP 能保留它代表的绝对时间；如果输入只有 2026-09-14 01:30:00，就必须约定它来自 UTC、服务器默认时区还是业务所在地。不要让无时区字符串在不同部署环境中自行解释。

自定义 pattern 时还要记住它属于 ICU：yyyy-MM-dd HH:mm 与 PHP Y-m-d H:i 不是同一套符号。可以这样明确指定：

setTimezone(new DateTimeZone('Asia/Shanghai'));

// PATTERN 使用 ICU 模式，yyyy 与 HH 的含义不要按 date() 规则替换。
$formatter = new IntlDateFormatter(
    'zh_CN',
    IntlDateFormatter::NONE,
    IntlDateFormatter::NONE,
    $local->getTimezone(),
    IntlDateFormatter::GREGORIAN,
    'yyyy-MM-dd HH:mm z'
);

// 失败时返回 false，随后读取 formatter 的错误信息定位模式或输入问题。
$result = $formatter->format($local);
if ($result === false) {
    throw new RuntimeException($formatter->getErrorMessage());
}
echo $result, PHP_EOL;
?>

如果需要让 formatter 跟随传入对象的时区，也可以先调用 setTimeZone($date->getTimezone())，或使用 IntlDateFormatter::formatObject()。在团队代码里，我更倾向于统一构造时区，减少调用者忘记同步的机会。

用 timezone id、偏移量和错误信息完成核对

时区不一致时，先看下面这张小表，再动默认配置。它能把“时间点错了”和“只是显示规则不同”分开。

不要把 date_default_timezone_set() 当成万能修复。它只设置脚本中日期函数的默认时区；显式创建的 DateTimeZone 和 formatter 配置仍然应该由业务代码负责。数据库建议保存统一的时间基准，到了展示层再转换为用户时区。

常见问题

为什么 DateTime 显示是上海时间，IntlDateFormatter 却是 UTC？

因为 formatter 使用自己的 timezone 参数；传入 DateTime 对象时不会自动采用对象时区。检查并统一 new IntlDateFormatter(..., $timezone, ...)。

setTimezone() 会把数据库里的时间改掉吗？

对 DateTimeImmutable 来说，它返回一个新对象，底层时间点不变，只改变新的显示时区。保存前仍应明确你要保存的是时间点还是本地日期。

IntlDateFormatter 的 yyyy 能换成 PHP 的 Y 吗？

不能直接替换。自定义 pattern 采用 ICU 日期字段符号；固定机器可读格式可改用 PHP 的 format()，不要混用两套模式。