PHP IntlTimeZone 怎样查询时区所属的地区代码

在 PHP 中，IntlTimeZone::getRegion() 用来根据一个系统时区 ID 查询它关联的地区代码。最小用法是传入 Asia/Shanghai 这类 IANA 时区 ID，成功时得到两位字母代码，失败时得到 false。生产代码要把这两个返回分支分开处理，不能把失败值当成空字符串继续写入业务数据。

官方文档：https://www.php.net/manual/en/intltimezone.getregion.php

先分清时区 ID、地区代码和展示名称

Asia/Shanghai 是时区 ID，描述的是一组时间规则；CN 是地区代码，表示它关联的地区；“中国标准时间”则更像给用户看的名称。三者用途不同，运行手册里最好分别记录，避免把地区代码重新拼成时区 ID。

用 IntlTimeZone::getRegion 查询地区代码

方法是静态调用，参数是字符串时区 ID。下面的示例把查询封装成一个小函数，并保留失败原因，方便放进批处理或接口参数整理流程：

这个写法有两个关键点：不使用宽松的真假判断掩盖输入问题，并让函数返回 ?string，把“没有地区代码”显式传给调用方。若项目启用了命名空间，调用全局类时按项目约定写成 \IntlTimeZone，避免与自定义类重名。

在业务分支中使用返回结果

拿到地区代码后，通常还要做白名单判断或映射。例如只允许少数地区进入某个区域化配置时，可以把未知代码落到默认分支，而不是把所有非空字符串都当作已支持地区：

 'zh-CN',
        'US' => 'en-US',
        default => 'default',
    };
}

这里的地区代码是业务路由线索，不等于完整的时间规则。需要计算夏令时、偏移量或历史变化时，仍应继续使用原始时区 ID 和对应的日期时间 API；不要只保存 CN、US 这样的结果。

出现空值或 false 时怎样排查

值班排障时可以按“输入是否为空—扩展是否可调用—返回是否为 false—白名单是否命中—是否保留原始 ID”这个顺序检查。日志中不要只打印地区代码，否则无法还原用户传入的时区。

相关问题

getRegion 返回的是国家名称吗？

不是。它返回地区代码，通常是两位字母形式；展示名称需要另外根据地区代码和语言环境做本地化。

拿到地区代码后能替代时区 ID 吗？

不能。一个地区可能包含多个时区规则，地区代码不携带完整的偏移量、夏令时和历史信息。计算时间时应保留原始时区 ID。

为什么不能只判断返回值是否为空？

官方返回边界是字符串或 false。显式使用 === false 可以避免把失败、空输入和有效但未命中的业务映射混在一起。