PHP IntlDatePatternGenerator 怎样从骨架取得本地日期格式

如果同一份日期数据要面向中文、英文等不同地区显示，直接写死 `Y-m-d` 往往只能得到一种固定格式。PHP 的 `IntlDatePatternGenerator` 可以把“需要年、月、日、星期”等字段表达成 skeleton，再结合 locale 生成适合该地区的日期格式模式；这个模式随后交给 `IntlDateFormatter` 输出。

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

先分清 skeleton、模式和最终文本

IntlDatePatternGenerator 的职责是生成适合本地化日期/时间格式的 pattern。比如 yMMMd 表示希望包含年、月、日，但它不是要求输出固定的“2026年10月30日”，也不是 IntlDateFormatter 最终返回的文本。不同 locale 可以根据同一组字段选择不同顺序、月份宽度和分隔符。

该类在 PHP 8.1 及更高版本的手册中提供。使用前需要启用 intl 扩展；如果类不存在，应该先检查运行环境，而不是把问题误判成 skeleton 写错。

getBestPattern($skeleton);
if ($pattern === false) {
    throw new RuntimeException('无法根据 skeleton 取得日期模式');
}

echo $pattern;

这里的 y、M、d 是字段意图，重复次数可以表达期望的字段宽度。不要把生成出来的模式保存成跨 locale 通用的常量；它只在对应 locale 和 ICU 环境下有本地化意义。

用 create 和 getBestPattern 取得本地日期模式

最常见的调用路径是先选定 locale，再把业务需要的字段写成 skeleton。create() 返回生成器对象或 null，getBestPattern() 接受字符串并返回模式或 false，因此两处都要显式处理失败结果。

如果应用同时支持多个地区，可以把 locale 作为请求上下文的一部分传入，而不是先生成一个中文模式、再把它套到英文页面。下面的函数只负责“取得模式”，不负责格式化日期，职责更容易测试和复用：

getBestPattern($skeleton);
    if ($pattern === false) {
        throw new InvalidArgumentException('skeleton 没有生成可用模式');
    }

    return $pattern;
}

$pattern = bestDatePattern('en_US', 'yMMMd');

同一 skeleton 在不同 locale 下可能得到不同的 pattern，这正是使用生成器的意义。业务代码只需要声明“年、月、日”或“月、日、星期”，不要在这一层提前拼接逗号、斜线或中文单位。

把模式交给 IntlDateFormatter 并单独处理时区

取得 pattern 后，再把它传给 IntlDateFormatter 的最后一个参数。日期类型和时间类型可以使用 NONE，让自定义 pattern 接管显示字段；时区仍然要明确设置，否则同一时间戳在服务端和用户端可能出现日期跨天。

format($date);
if ($text === false) {
    throw new RuntimeException('日期格式化失败');
}

echo $text;

生成器只负责模式选择，不负责把时间戳转换成用户看到的时刻。把“locale 选择”和“timezone 选择”分开，能够避免把地区偏好误当成时区，也方便接口统一使用 UTC 存储、展示时再转换。

字段选择与常见误区速查

• 不要把 skeleton 直接交给 date()；它们不是同一种格式语法。
• 不要只切换页面语言而复用旧 pattern；locale 改变后应重新取得 pattern。
• 不要把时区写进 skeleton；时区是 formatter 的配置。
• 不要忽略 null、false 和格式化失败，否则部署差异会变成空白日期。

常见问题

IntlDatePatternGenerator 会直接返回格式化后的日期吗？

不会。它返回适合 locale 的 pattern 字符串，真正把日期值变成文本的是 IntlDateFormatter。

同一个 skeleton 在所有语言中输出会一样吗？

不会。skeleton 只表达字段需求，字段顺序、月份名称、分隔符和小时制等本地化细节由 locale 和 ICU 决定。

为什么已经传入 DateTime 还要设置 formatter 时区？

因为格式化器的时区决定最终显示的时刻。若服务端统一保存 UTC，而展示地区不同，就应在 formatter 层明确指定目标时区。