陈随易

从 v2 开始，格式化和解析使用 Unicode 标记。

这些标记与 Moment.js 和其他选择使用自定义格式规则的库不同。

虽然使用标准可以确保兼容性和库的未来，但它会造成混淆，而本文档旨在解决这一问题。

常见错误

最容易引起混淆的是 4 个标记：

表示一年中的第几天 (1、2、...、365、366) 的 D 和 DD 经常与表示一个月中的第几天 (1、2、...、31) 的 d 和 dd 混淆。
代表当地周数年份 (44、01、00、17) 的 YY 和 YYYY 经常与代表日历年份的 yy 和 yyyy 混淆。

// ❌ 错误
format(new Date(), 'YYYY-MM-DD');
//=> 2018-10-283

// ✅ 正确
format(new Date(), 'yyyy-MM-dd');
//=> 2018-10-10

// ❌ 错误
parse('11.02.87', 'D.MM.YY', new Date()).toString();
//=> 'Sat Jan 11 1986 00:00:00 GMT+0200 (EET)'

// ✅ 正确
parse('11.02.87', 'd.MM.yy', new Date()).toString();
//=> 'Wed Feb 11 1987 00:00:00 GMT+0200 (EET)'

为了解决这个问题，如果没有 useAdditionalDayOfYearTokens 选项 (对于 D 和 DD) 以及 useAdditionalWeekYearTokens 选项 (对于 YY 和 YYYY)，格式化和解析函数将不会接受这些标记：

format(new Date(), 'D', { useAdditionalDayOfYearTokens: true });
//=> '283'

parse('365+1987', 'DD+YYYY', new Date(), {
    useAdditionalDayOfYearTokens: true,
    useAdditionalWeekYearTokens: true
}).toString();
//=> 'Wed Dec 31 1986 00:00:00 GMT+0200 (EET)'

常见错误 ​

常见错误