Globalize 1.3.0 版本深度解析：国际化日期时间处理新突破

华朔珍Elena

于 2025-06-08 09:20:49 发布

阅读量231

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00654/article/details/148508722

版权

Globalize 1.3.0 版本深度解析：国际化日期时间处理新突破

globalize 项目地址: https://gitcode.com/gh_mirrors/glo/globalize

前言

Globalize 作为一款强大的国际化库，在1.3.0版本中带来了多项重大改进。本文将深入解析这些新特性，帮助开发者更好地理解和使用这些功能。

全面支持IANA/Olson时区

背景与挑战

在之前的版本中，Globalize对时区的支持有限，只能处理运行时的用户时区，无法完整显示CLDR模式中的时区字符串（如"PDT"、"Pacific Daylight Time"等）。这导致开发者需要额外引入moment-timezone等库来处理时区问题。

解决方案

1.3.0版本通过引入zoned-date-time库（仅0.6KB）实现了完整的IANA/Olson时区支持。这种实现方式既保持了轻量级，又提供了高性能。

使用示例

// 设置英文环境
Globalize.locale("en");
let date = new Date();

// 不同时区的短格式显示
Globalize.formatDate(date, {datetime: "short", timeZone: "America/Los_Angeles"});
// 输出: '3/19/17, 3:19 PM'

// 完整格式显示
Globalize.formatDate(date, {datetime: "full", timeZone: "America/Los_Angeles"});
// 输出: 'Sunday, March 19, 2017 at 3:19:22 PM Pacific Daylight Time'

// 多语言支持
Globalize("zh").formatDate(date, {datetime: "full", timeZone: "Asia/Shanghai"});
// 输出: '2017年3月20日星期一 中国标准时间 上午6:19:22'

性能考量

在生产环境中，使用Globalize Compiler预编译时区数据可以显著减小文件体积：

英文环境数据（包含CLDR和IANA数据）：约1.7KB
核心库+数字+日期处理+时区支持：约7.0KB

日期格式化到组件(Format Date To Parts)

功能背景

现代UI开发经常需要对日期格式的输出进行细粒度控制。传统格式化方法返回的是不透明的字符串，难以进行进一步处理。

新特性介绍

Globalize 1.3.0引入了.dateToPartsFormatter和.formatDateToParts方法，将日期分解为可操作的组件：

Globalize.locale("en");
Globalize.formatDateToParts(new Date(2010, 10, 30));
// 输出: [
//   { "type": "month", "value": "11" },
//   { "type": "literal", "value": "/" },
//   { "type": "day", "value": "30" },
//   { "type": "literal", "value": "/" },
//   { "type": "year", "value": "2010" }
// ]

实际应用

这种分解能力使得开发者可以灵活地自定义日期显示：

let formatter = Globalize.dateToPartsFormatter({datetime: "short"});

formatter(new Date(2010, 10, 30, 17, 55)).map(({type, value}) => {
  return type === "year" ? `<strong>${value}</strong>` : value;
}).join("");
// 输出: "11/30/<strong>10</strong>, 5:55 PM"

动态增强的日期骨架(Dynamically Augmented Date Skeletons)

功能背景

CLDR提供了预设的日期格式（如short、medium等），但开发者经常需要自定义格式。CLDR通过日期字段组合（称为skeleton）支持这种需求。

改进内容

1.3.0版本显著改进了skeleton处理算法：

对于直接匹配的skeleton（如{skeleton: "MMMd"}），行为与之前版本一致
对于需要推导的skeleton（如{skeleton: "MMMMd"}），现在可以正确地从相近格式推导
支持更复杂的组合，如"GyMMMMEEEEdhms"

使用示例

let skeleton = "GyMMMMEEEEdhms";
Globalize("zh").formatDate(new Date(), {skeleton});
// 输出: '公元2017年七月月1日星期六 下午5:01:35'
Globalize("ar").formatDate(new Date(), {skeleton});
// 输出: 'السبت، ١ يوليو، ٢٠١٧ م ٥:٠١:٤٠ م'