PHP Intl 日期格式化怎样明确时区

PHP 的 IntlDateFormatter 会按照 formatter 自己的时区来格式化日期。想让结果稳定，关键不是把服务器的默认时区调成某个值，而是在创建 formatter 时明确传入 DateTimeZone；如果 formatter 会被复用，再用 setTimeZone() 切换，并用 getTimeZoneId() 读取当前状态。

官方资料：https://www.php.net/manual/en/intldateformatter.create.php

下面用一个小场景贯穿：系统保存 UTC 瞬时值，页面需要按上海时区显示。这样可以把“时间点”和“展示时区”分开，避免换机器或换请求后出现偏移。

先把时区写进 formatter

最小实现是在 IntlDateFormatter::create() 的第四个参数传入时区。这里使用 IANA 时区标识对应的 DateTimeZone，不要把业务时区藏在全局配置里。

getTimeZoneId();

if ($timezoneId !== 'Asia/Shanghai') {
    // 读取状态比猜测默认时区更可靠。
    throw new RuntimeException('formatter 时区不是预期值');
}

echo $formatter->format($instant);

这个写法的重点是时区参数和格式模式都属于 formatter 的配置。DateTimeImmutable 携带的 UTC 信息没有被修改，formatter 只是按上海时区读取同一个瞬时值来生成文本。

复用 formatter 时先确认当前时区

如果一个长期存在的 formatter 服务多个用户，就不能只在初始化时设置一次然后默认它永远正确。切换前后读取 getTimeZoneId()，可以把时区状态变成可观察的配置。

setTimeZone(new DateTimeZone('Asia/Shanghai'));
$shanghaiId = $formatter->getTimeZoneId();
$shanghaiText = $formatter->format($instant);

$formatter->setTimeZone(new DateTimeZone('Europe/Berlin'));
$berlinId = $formatter->getTimeZoneId();
$berlinText = $formatter->format($instant);

// 业务层应把时区 ID 和格式化文本一起交给日志或响应对象。
var_dump($shanghaiId, $shanghaiText, $berlinId, $berlinText);

setTimeZone() 的参数可以是 IntlTimeZone、DateTimeZone、有效的 ICU 时区字符串或 null。实际工程里优先使用命名时区，并在请求边界重新设置，避免共享对象保留前一个用户的状态。

分清输入时区、输出时区和默认时区

最容易混淆的是：DateTimeImmutable 的时区描述输入对象如何解释或展示，而 IntlDateFormatter 的时区决定 formatter 如何输出。PHP 手册明确说明，用 formatter 格式化 DateTime 对象时，使用的是 formatter 的时区，而不是对象自身的时区。

如果传入 null，formatter 会使用 date.timezone 或 date_default_timezone_set() 提供的默认时区。默认值适合简单脚本，但在多租户、跨地区报表或异步任务里，显式时区更容易审查和复现。

把时区问题收敛成四个检查点

1. 创建 formatter 时是否传入了明确的命名时区，而不是依赖默认值。
2. 输入是否是明确的瞬时值，解析字符串时有没有附带正确时区。
3. formatter 是否被复用；如果会复用，每个请求是否都调用了 setTimeZone()。
4. 排错时是否记录 getTimeZoneId()、输入值和格式模式，而不是只记录最终字符串。

这样处理后，PHP Intl 日期格式化的时区就有了清晰边界：输入负责表达时间点，formatter 负责表达展示规则，状态读取负责让排查有依据。

常见问题

为什么传入 DateTimeZone 后结果仍然不对？

先分别打印输入对象的时区和 $formatter->getTimeZoneId()。如果字符串本身没有时区，问题可能发生在解析阶段；如果 formatter 被复用，也要检查是否被后续请求切换。

可以直接传入 Asia/Shanghai 字符串吗？

可以，PHP 手册允许传入有效的 ICU 时区标识；使用 DateTimeZone 对象更容易在代码审查时看出这是一个时区配置。

只设置 date_default_timezone_set() 够不够？

小脚本可以，但共享组件或多地区业务不建议只依赖全局默认值。把时区传给 formatter，并在复用前读取状态，边界会更清楚。