date-fns 罗马尼亚语(ro)Locale 完整指南:format/parse 令牌快照与本地化实现解析
date-fns 罗马尼亚语(ro)Locale 完整指南:format/parse 令牌快照与本地化实现解析
本篇技术指南围绕 date-fns 仓库中罗马尼亚语(Romanian,locale 代码 ro)的官方行为快照文档 snapshot.md 展开。该快照逐令牌记录了 format、parse、formatDistance、formatDistanceStrict、formatRelative、formatDuration 六组 API 在 ro locale 下的精确输出,是罗马尼亚语本地化的"行为契约"与回归测试基准。读完本文,你将掌握 ro locale 的完整令牌映射、单复数与性别屈折规则、前后缀拼接逻辑,并能对照 实现源码 理解这些输出背后的构造原理。
snapshot.md 是什么:locale 的行为契约
date-fns 的每个 locale 目录(如 pkgs/core/src/locale/ro/)都带有一份 snapshot.md。它由仓库脚本对 locale 对象执行真实的 format/parse/formatDistance 等调用后生成,记录了固定输入日期下的固定输出字符串。任何对 locale 翻译或正则的修改,只要导致输出变化,就会与快照产生 diff——因此它既是翻译人员的参照表,也是自动化的行为回归基准。
罗马尼亚语 locale 的完整实现由五个 _lib 子模块组成:
| 模块 | 相对路径 | 职责 |
|---|---|---|
formatDistance |
pkgs/core/src/locale/ro/_lib/formatDistance/index.ts | 距离短语与前后缀("în …" / "… în urmă") |
formatLong |
pkgs/core/src/locale/ro/_lib/formatLong/index.ts | P/p 系列长格式模板 |
formatRelative |
pkgs/core/src/locale/ro/_lib/formatRelative/index.ts | 相对时间(昨天/今天/明天等)模板 |
localize |
pkgs/core/src/locale/ro/_lib/localize/index.ts | 年/季/月/星期/时段的多级宽度词汇表 |
match |
pkgs/core/src/locale/ro/_lib/match/index.ts | parse 使用的匹配与解析正则 |
入口文件 index.ts 将以上模块组装为 Locale 对象,并声明 locale 级选项:weekStartsOn: 1(周一为一周起点)、firstWeekContainsDate: 1(一年中第一个含 1 月 1 日的周为第 1 周),这与快照中本地周编号(wo/Yo)的结果完全一致。
在项目中使用 ro locale
在 ESM 环境下,通过子路径导入 locale 并作为 locale 选项传入 API:
import { format, parse, formatDistance } from "date-fns";
import { ro } from "date-fns/locale";
format(new Date("1987-02-11T12:13:14"), "PPPP", { locale: ro });
// => "miercuri, 11 februarie 1987"
parse("11 februarie 1987", "d MMMM yyyy", new Date(), { locale: ro });
// => Date(1987-02-11T00:00:00.000Z)
formatDistance(new Date("2000-01-02"), new Date("2000-01-01"), {
locale: ro,
addSuffix: true,
});
// => "în 1 zi"
Locale 接口的完整字段定义(code、formatDistance、formatRelative、localize、formatLong、match、options)见 pkgs/core/src/locale/types.ts,所有 locale 均遵循同一契约。
format 与 parse 令牌快照
下表为快照文档 ## format and parse 部分的完整数据。所有输入日期均为 UTC(.015Z 毫秒部分)。parse 结果列展示的是将左侧 format 输出反向解析得到的日期;显示 Invalid Date 表示该宽度形式可格式化但不可被 parse 反向匹配,Errored 表示解析时抛错(时区令牌 z/zzzz 不参与解析)。
年份与季度
| 标题 | 令牌 | 日期 | format 结果 |
parse 结果 |
|---|---|---|---|---|
| Calendar year(日历年) | yo | 1987-02-11T12:13:14.015Z | 1987 | 1987-01-01T00:00:00.000Z |
| 0005-01-01T12:13:14.015Z | 5 | 0005-01-01T00:00:00.000Z | ||
| Local week-numbering year(本地周编号年) | Yo | 1987-02-11T12:13:14.015Z | 1987 | 1986-12-29T00:00:00.000Z |
| 0005-01-01T12:13:14.015Z | 5 | 0004-12-27T00:00:00.000Z | ||
| Quarter (formatting)(季度-格式上下文) | Qo | 2019-01-01T12:13:14.015Z | 1 | 2019-01-01T00:00:00.000Z |
| 2019-04-01T12:13:14.015Z | 2 | 2019-04-01T00:00:00.000Z | ||
| QQQ | 2019-01-01T12:13:14.015Z | T1 | 2019-01-01T00:00:00.000Z | |
| 2019-04-01T12:13:14.015Z | T2 | 2019-04-01T00:00:00.000Z | ||
| QQQQ | 2019-01-01T12:13:14.015Z | primul trimestru | Invalid Date | |
| 2019-04-01T12:13:14.015Z | al doilea trimestru | Invalid Date | ||
| QQQQQ | 2019-01-01T12:13:14.015Z | 1 | 2019-01-01T00:00:00.000Z | |
| 2019-04-01T12:13:14.015Z | 2 | 2019-04-01T00:00:00.000Z | ||
| Quarter (stand-alone)(季度-独立上下文) | qo | 2019-01-01T12:13:14.015Z | 1 | 2019-01-01T00:00:00.000Z |
| 2019-04-01T12:13:14.015Z | 2 | 2019-04-01T00:00:00.000Z | ||
| qqq | 2019-01-01T12:13:14.015Z | T1 | 2019-01-01T00:00:00.000Z | |
| 2019-04-01T12:13:14.015Z | T2 | 2019-04-01T00:00:00.000Z | ||
| qqqq | 2019-01-01T12:13:14.015Z | primul trimestru | Invalid Date | |
| 2019-04-01T12:13:14.015Z | al doilea trimestru | Invalid Date |
季度完整写法(QQQQ/qqqq)在 localize/index.ts 中定义为 primul trimestru、al doilea trimestru、al treilea trimestru、al patrulea trimestru,属于序数词组而非简单数字,因此 parse 的季度匹配(match/index.ts 只接受 /^T[1234]/ 与 /^trimestrul [1234]/)无法将其还原为数字,快照中表现为 Invalid Date。
月份(formatting 与 stand-alone)
M 系列为格式上下文(出现在句子中),L 系列为独立上下文(单独列举月份)。罗马尼亚语两个上下文的词汇表完全一致,均定义于 localize/index.ts。
| 令牌 | 1月 | 2月 | 3月 | 4月 | 5月 | 6月 | 7月 | 8月 | 9月 | 10月 | 11月 | 12月 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Mo / Lo(序数) | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 |
| MMM / LLL(缩写) | ian | feb | mar | apr | mai | iun | iul | aug | sep | oct | noi | dec |
| MMMM / LLLL(全称) | ianuarie | februarie | martie | aprilie | mai | iunie | iulie | august | septembrie | octombrie | noiembrie | decembrie |
| MMMMM / LLLLL(narrow) | I | F | M | A | M | I | I | A | S | O | N | D |
parse 对窄宽度(narrow,单字母)的解析结果需要特别注意:5 月(M)解析为 3 月、6 月(I)解析为 1 月、7 月(I)解析为 1 月、8 月(A)解析为 4 月——因为窄宽度单字母存在歧义(如 I 同时是 1/6/7 月、M 同时是 3/5 月、A 同时是 4/8 月),match/index.ts 的窄宽度解析数组按"第一个命中"顺序返回,快照如实记录了这一歧义行为。全称与缩写(MMMM/MMM)的解析则精确无误。
周、日与序数
| 标题 | 令牌 | 日期 | format 结果 |
parse 结果 |
|---|---|---|---|---|
| Local week of year(本地年第几周) | wo | 2019-01-01T12:13:14.015Z | 1 | 2018-12-31T00:00:00.000Z |
| 2019-12-01T12:13:14.015Z | 48 | 2019-11-25T00:00:00.000Z | ||
| ISO week of year(ISO 年第几周) | Io | 2019-01-01T12:13:14.015Z | 1 | 2018-12-31T00:00:00.000Z |
| 2019-12-01T12:13:14.015Z | 48 | 2019-11-25T00:00:00.000Z | ||
| Day of month(月内日) | do | 2019-02-01T12:13:14.015Z | 1 | 2019-02-01T00:00:00.000Z |
| 2019-02-11T12:13:14.015Z | 11 | 2019-02-11T00:00:00.000Z | ||
| 2019-02-28T12:13:14.015Z | 28 | 2019-02-28T00:00:00.000Z | ||
| do MMMM | 2019-02-01T12:13:14.015Z | 1 februarie | 2019-02-01T00:00:00.000Z | |
| 2019-02-11T12:13:14.015Z | 11 februarie | 2019-02-11T00:00:00.000Z | ||
| 2019-02-28T12:13:14.015Z | 28 februarie | 2019-02-28T00:00:00.000Z | ||
| Day of year(年内日) | Do | 2019-02-11T12:13:14.015Z | 42 | 2019-02-11T00:00:00.000Z |
| 2019-12-31T12:13:14.015Z | 365 | 2019-12-31T00:00:00.000Z |
罗马尼亚语没有独立的序数后缀(不似英语的 1st/2nd):localize/index.ts 中的 ordinalNumber 直接把数字转为字符串,这就是 yo/wo/do 等序数令牌输出纯数字的原因。
星期(多种宽度 × 多种体系)
罗马尼亚语星期的窄宽度单字母存在歧义:m 同时代表 marți(周二)与 miercuri(周三),j 代表 joi(周四)。format 的 narrow 输出为小写单字母 l(luni)、m(marți)、m(miercuri)、j、v、s;EEEEE/iiiii/eeeee/ccccc 均为该形式,而 parse 只对 l、v(唯一无歧义的)成功,其余返回 Invalid Date。完整数据如下:
| 标题 | 令牌 | 2019-02-11(周一) | 2019-02-15(周五) |
|---|---|---|---|
| Day of week (formatting) | E / EE / EEE | lun | vin(Invalid Date) |
| EEEE | luni | vineri | |
| EEEEE | l | v | |
| EEEEEE | lu(Invalid Date) |
vi(Invalid Date) |
|
| ISO day of week (formatting) | io | 1 | 5 |
| iii | lun | vin(Invalid Date) |
|
| iiii | luni | vineri | |
| iiiii | l | v | |
| iiiiii | lu(Invalid Date) |
vi(Invalid Date) |
|
| Local day of week (formatting) | eo | 1 | 5 |
| eee | lun | vin(Invalid Date) |
|
| eeee | luni | vineri | |
| eeeee | l | v | |
| eeeeee | lu(Invalid Date) |
vi(Invalid Date) |
|
| Local day of week (stand-alone) | co | 1 | 5 |
| ccc | lun | vin(Invalid Date) |
|
| cccc | luni | vineri | |
| ccccc | l | v | |
| cccccc | lu(Invalid Date) |
vi(Invalid Date) |
注意 parse 对 EEE(vin)与 EEEEEE(vi)均失败,但 EEEE(vineri)成功:原因在 match/index.ts 的星期匹配正则只提供 abbreviated(dum|lun|mar|mie|jo|vi|sâ)与 wide(duminica|luni|marţi|miercuri|joi|vineri|sâmbătă)两组可解析模式,缺少 short(du|lu|ma|mi|jo|vi|sâ)解析模式,导致 lu/vi 无法匹配。星期的完整宽度词汇见 localize/index.ts。
时段、小时、分钟、秒
| 标题 | 令牌 | 11:13 | 14:13 | 19:13 | 02:13 |
|---|---|---|---|---|---|
| AM, PM | a / aa | AM | PM | PM | AM |
| aaa / bbb | am | pm | pm | am | |
| aaaa / bbbb | a.m. | p.m. | p.m. | a.m. | |
| aaaaa / bbbbb | a | p | p | a | |
| Flexible day period | B / BB / BBB / BBBB / BBBBB | dimineață | după-amiază | seară | noapte |
上表日期均为 2019-02-11。时段窄/缩写/全称词汇定义于 localize/index.ts(dayPeriodValues 与 formattingDayPeriodValues)。快照显示 a/b 系列可被 parse 还原(AM→00:00、PM→12:00),而柔性时段 B 系列(dimineață/după-amiază/seară/noapte)虽然能格式化,但 parse 一律返回 Invalid Date。
| 标题 | 令牌 | 输入时间 | format 结果 |
parse 结果 |
|---|---|---|---|---|
| Hour [1-12] | ho | 2019-02-11T11:13:14.015Z | 11 | 2019-02-11T11:00:00.000Z |
| 2019-02-11T23:13:14.015Z | 11 | 2019-02-11T23:00:00.000Z | ||
| Hour [0-23] | Ho | 2019-02-11T11:13:14.015Z | 11 | 2019-02-11T11:00:00.000Z |
| 2019-02-11T23:13:14.015Z | 23 | 2019-02-11T23:00:00.000Z | ||
| Hour [0-11] | Ko | 2019-02-11T11:13:14.015Z | 11 | 2019-02-11T11:00:00.000Z |
| 2019-02-11T23:13:14.015Z | 11 | 2019-02-11T23:00:00.000Z | ||
| Hour [1-24] | ko | 2019-02-11T11:13:14.015Z | 11 | 2019-02-11T11:00:00.000Z |
| 2019-02-11T23:13:14.015Z | 23 | 2019-02-11T23:00:00.000Z | ||
| Minute | mo | 2019-01-01T12:01:14.015Z | 1 | 2019-01-01T12:01:00.000Z |
| 2019-04-01T12:55:14.015Z | 55 | 2019-04-01T12:55:00.000Z | ||
| Second | so | 2019-01-01T12:13:01.015Z | 1 | 2019-01-01T12:13:01.000Z |
| 2019-04-01T12:13:55.015Z | 55 | 2019-04-01T12:13:55.000Z |
长格式日期(P 系列)、时间(p 系列)与组合
P/p 系列模板定义于 formatLong/index.ts:
| 宽度 | 日期模板 | 时间模板 | 日期+时间模板 |
|---|---|---|---|
| short | dd.MM.yyyy |
HH:mm |
{{date}}, {{time}} |
| medium | d MMM yyyy |
HH:mm:ss |
{{date}}, {{time}} |
| long | d MMMM yyyy |
HH:mm:ss z |
{{date}} 'la' {{time}} |
| full | EEEE, d MMMM yyyy |
HH:mm:ss zzzz |
{{date}} 'la' {{time}} |
快照样例(以 1987-01-11 为例,1453-05-29 行用于验证历史日期):
| 令牌 | format 结果 |
parse 结果 |
|---|---|---|
| P | 11.01.1987 | 1987-01-11T00:00:00.000Z |
| PP | 11 ian 1987 | 1987-01-11T00:00:00.000Z |
| PPP | 11 ianuarie 1987 | 1987-01-11T00:00:00.000Z |
| PPPP | duminică, 11 ianuarie 1987 | Invalid Date(同日另有 miercuri、sâmbătă、joi、vineri、marți 等行全部成功解析) |
| p | 12:13 | 1987-01-11T12:13:00.000Z |
| pp | 12:13:14 | 1987-01-11T12:13:14.000Z |
| ppp / pppp | 12:13:14 GMT+0 / 12:13:14 GMT+00:00 | Errored |
| Pp | 11.01.1987, 12:13 | 1987-01-11T12:13:00.000Z |
| PPpp | 11 ian 1987, 12:13:14 | 1987-01-11T12:13:14.000Z |
| PPPppp | 11 ianuarie 1987 la 12:13:14 GMT+0 | Errored |
| PPPPpppp | duminică, 11 ianuarie 1987 la 12:13:14 GMT+00:00 | Invalid Date / Errored |
要点:PPPP 中带 EEEE, 前缀的完整形式里,部分星期与月份的"月名大写变体 + 逗号"组合可解析、部分不可解析(如 1 月 duminică、8 月 marți、10 月 duminică 失败,而 2/3/6/9/11/12 月成功)——这反映在快照中即为逐行 Invalid Date;含时区令牌 z/zzzz 的形式(ppp 及以上)parse 一律 Errored,因为 date-fns 的 parse 不支持时区令牌。罗马尼亚语用介词 la(意为"在/于")连接日期与时间,对应 dateTimeFormats 中的 'la' 字面量。
formatDistance 快照
基准时刻:now 为 2000 年 1 月 1 日 00:00。三列分别对应默认输出、includeSeconds: true 与 addSuffix: true:
| 日期 | 结果 | includeSeconds: true |
addSuffix: true |
|---|---|---|---|
| 2006-01-01T00:00:00.000Z | circa 6 ani | circa 6 ani | în circa 6 ani |
| 2005-01-01T00:00:00.000Z | circa 5 ani | circa 5 ani | în circa 5 ani |
| 2004-01-01T00:00:00.000Z | circa 4 ani | circa 4 ani | în circa 4 ani |
| 2003-01-01T00:00:00.000Z | circa 3 ani | circa 3 ani | în circa 3 ani |
| 2002-01-01T00:00:00.000Z | circa 2 ani | circa 2 ani | în circa 2 ani |
| 2001-06-01T00:00:00.000Z | peste 1 an | peste 1 an | în peste 1 an |
| 2001-02-01T00:00:00.000Z | circa 1 an | circa 1 an | în circa 1 an |
| 2001-01-01T00:00:00.000Z | circa 1 an | circa 1 an | în circa 1 an |
| 2000-06-01T00:00:00.000Z | 5 luni | 5 luni | în 5 luni |
| 2000-03-01T00:00:00.000Z | 2 luni | 2 luni | în 2 luni |
| 2000-02-01T00:00:00.000Z | circa 1 lună | circa 1 lună | în circa 1 lună |
| 2000-01-15T00:00:00.000Z | 14 zile | 14 zile | în 14 zile |
| 2000-01-02T00:00:00.000Z | 1 zi | 1 zi | în 1 zi |
| 2000-01-01T06:00:00.000Z | circa 6 ore | circa 6 ore | în circa 6 ore |
| 2000-01-01T01:00:00.000Z | circa 1 oră | circa 1 oră | în circa 1 oră |
| 2000-01-01T00:45:00.000Z | circa 1 oră | circa 1 oră | în circa 1 oră |
| 2000-01-01T00:30:00.000Z | 30 minute | 30 minute | în 30 minute |
| 2000-01-01T00:15:00.000Z | 15 minute | 15 minute | în 15 minute |
| 2000-01-01T00:01:00.000Z | 1 minut | 1 minut | în 1 minut |
| 2000-01-01T00:00:25.000Z | mai puțin de un minut | jumătate de minut | în mai puțin de un minut |
| 2000-01-01T00:00:15.000Z | mai puțin de un minut | mai puțin de 20 secunde | în mai puțin de un minut |
| 2000-01-01T00:00:05.000Z | mai puțin de un minut | mai puțin de 10 secunde | în mai puțin de un minut |
| 2000-01-01T00:00:00.000Z | mai puțin de un minut | mai puțin de 5 secunde | mai puțin de un minut în urmă |
| 1999-12-31T23:59:55.000Z | mai puțin de un minut | mai puțin de 10 secunde | mai puțin de un minut în urmă |
| 1999-12-31T23:59:45.000Z | mai puțin de un minut | mai puțin de 20 secunde | mai puțin de un minut în urmă |
| 1999-12-31T23:59:35.000Z | mai puțin de un minut | jumătate de minut | mai puțin de un minut în urmă |
| 1999-12-31T23:59:00.000Z | 1 minut | 1 minut | 1 minut în urmă |
| 1999-12-31T23:45:00.000Z | 15 minute | 15 minute | 15 minute în urmă |
| 1999-12-31T23:30:00.000Z | 30 minute | 30 minute | 30 minute în urmă |
| 1999-12-31T23:15:00.000Z | circa 1 oră | circa 1 oră | circa 1 oră în urmă |
| 1999-12-31T23:00:00.000Z | circa 1 oră | circa 1 oră | circa 1 oră în urmă |
| 1999-12-31T18:00:00.000Z | circa 6 ore | circa 6 ore | circa 6 ore în urmă |
| 1999-12-30T00:00:00.000Z | 2 zile | 2 zile | 2 zile în urmă |
| 1999-12-15T00:00:00.000Z | 17 zile | 17 zile | 17 zile în urmă |
| 1999-12-01T00:00:00.000Z | circa 1 lună | circa 1 lună | circa 1 lună în urmă |
| 1999-11-01T00:00:00.000Z | 2 luni | 2 luni | 2 luni în urmă |
| 1999-06-01T00:00:00.000Z | 7 luni | 7 luni | 7 luni în urmă |
| 1999-01-01T00:00:00.000Z | circa 1 an | circa 1 an | circa 1 an în urmă |
| 1998-12-01T00:00:00.000Z | circa 1 an | circa 1 an | circa 1 an în urmă |
| 1998-06-01T00:00:00.000Z | peste 1 an | peste 1 an | peste 1 an în urmă |
| 1998-01-01T00:00:00.000Z | circa 2 ani | circa 2 ani | circa 2 ani în urmă |
| 1997-01-01T00:00:00.000Z | circa 3 ani | circa 3 ani | circa 3 ani în urmă |
| 1996-01-01T00:00:00.000Z | circa 4 ani | circa 4 ani | circa 4 ani în urmă |
| 1995-01-01T00:00:00.000Z | circa 5 ani | circa 5 ani | circa 5 ani în urmă |
| 1994-01-01T00:00:00.000Z | circa 6 ani | circa 6 ani | circa 6 ani în urmă |
formatDistance 的实现逻辑在 formatDistance/index.ts:每个令牌是一组 { one, other } 模板,count === 1 取 one,否则用 {{count}} 占位替换;addSuffix 开启时,未来时间(comparison > 0)在结果前加 în ("在…之后"),过去时间在结果后加 în urmă("…之前")。注意 one 模板写死数字(如 "1 zi"、"1 minut"),不经过 {{count}} 替换。
罗马尼亚语数字单位的屈折要点:an/ani(年)、lună/luni(月)、săptămână/săptămâni(周)、zi/zile(天)、oră/ore(小时)、minut/minute(分钟)、secundă/secunde(秒),均为单数/复数两种形式,通过 one/other 字段实现,见 formatDistance/index.ts。距离大于 1 年时用 circa(约)或 peste(超过)修饰,小于 1 分钟时用 mai puțin de un minut(不到一分钟)与 jumătate de minut(半分钟)。
formatDistanceStrict 快照
基准时刻同为 2000 年 1 月 1 日 00:00。formatDistanceStrict 不做"约/超过"修饰,直接输出精确单位;第三列展示强制指定 unit: "hour" 时的结果(所有时长折算为小时数):
| 日期 | 结果 | addSuffix: true |
强制单位(hour) |
|---|---|---|---|
| 2006-01-01T00:00:00.000Z | 6 ani | în 6 ani | 52608 ore |
| 2005-01-01T00:00:00.000Z | 5 ani | în 5 ani | 43848 ore |
| 2004-01-01T00:00:00.000Z | 4 ani | în 4 ani | 35064 ore |
| 2003-01-01T00:00:00.000Z | 3 ani | în 3 ani | 26304 ore |
| 2002-01-01T00:00:00.000Z | 2 ani | în 2 ani | 17544 ore |
| 2001-06-01T00:00:00.000Z | 1 an | în 1 an | 12408 ore |
| 2001-02-01T00:00:00.000Z | 1 an | în 1 an | 9528 ore |
| 2001-01-01T00:00:00.000Z | 1 an | în 1 an | 8784 ore |
| 2000-06-01T00:00:00.000Z | 5 luni | în 5 luni | 3648 ore |
| 2000-03-01T00:00:00.000Z | 2 luni | în 2 luni | 1440 ore |
| 2000-02-01T00:00:00.000Z | 1 lună | în 1 lună | 744 ore |
| 2000-01-15T00:00:00.000Z | 14 zile | în 14 zile | 336 ore |
| 2000-01-02T00:00:00.000Z | 1 zi | în 1 zi | 24 ore |
| 2000-01-01T06:00:00.000Z | 6 ore | în 6 ore | 6 ore |
| 2000-01-01T01:00:00.000Z | 1 oră | în 1 oră | 1 oră |
| 2000-01-01T00:45:00.000Z | 45 minute | în 45 minute | 1 oră |
| 2000-01-01T00:30:00.000Z | 30 minute | în 30 minute | 1 oră |
| 2000-01-01T00:15:00.000Z | 15 minute | în 15 minute | 0 ore |
| 2000-01-01T00:01:00.000Z | 1 minut | în 1 minut | 0 ore |
| 2000-01-01T00:00:25.000Z | 25 secunde | în 25 secunde | 0 ore |
| 2000-01-01T00:00:15.000Z | 15 secunde | în 15 secunde | 0 ore |
| 2000-01-01T00:00:05.000Z | 5 secunde | în 5 secunde | 0 ore |
| 2000-01-01T00:00:00.000Z | 0 secunde | 0 secunde în urmă | 0 ore |
| 1999-12-31T23:59:55.000Z | 5 secunde | 5 secunde în urmă | 0 ore |
| 1999-12-31T23:59:45.000Z | 15 secunde | 15 secunde în urmă | 0 ore |
| 1999-12-31T23:59:35.000Z | 25 secunde | 25 secunde în urmă | 0 ore |
| 1999-12-31T23:59:00.000Z | 1 minut | 1 minut în urmă | 0 ore |
| 1999-12-31T23:45:00.000Z | 15 minute | 15 minute în urmă | 0 ore |
| 1999-12-31T23:30:00.000Z | 30 minute | 30 minute în urmă | 1 oră |
| 1999-12-31T23:15:00.000Z | 45 minute | 45 minute în urmă | 1 oră |
| 1999-12-31T23:00:00.000Z | 1 oră | 1 oră în urmă | 1 oră |
| 1999-12-31T18:00:00.000Z | 6 ore | 6 ore în urmă | 6 ore |
| 1999-12-30T00:00:00.000Z | 2 zile | 2 zile în urmă | 48 ore |
| 1999-12-15T00:00:00.000Z | 17 zile | 17 zile în urmă | 408 ore |
| 1999-12-01T00:00:00.000Z | 1 lună | 1 lună în urmă | 744 ore |
| 1999-11-01T00:00:00.000Z | 2 luni | 2 luni în urmă | 1464 ore |
| 1999-06-01T00:00:00.000Z | 7 luni | 7 luni în urmă | 5136 ore |
| 1999-01-01T00:00:00.000Z | 1 an | 1 an în urmă | 8760 ore |
| 1998-12-01T00:00:00.000Z | 1 an | 1 an în urmă | 9504 ore |
| 1998-06-01T00:00:00.000Z | 2 ani | 2 ani în urmă | 13896 ore |
| 1998-01-01T00:00:00.000Z | 2 ani | 2 ani în urmă | 17520 ore |
| 1997-01-01T00:00:00.000Z | 3 ani | 3 ani în urmă | 26280 ore |
| 1996-01-01T00:00:00.000Z | 4 ani | 4 ani în urmă | 35064 ore |
| 1995-01-01T00:00:00.000Z | 5 ani | 5 ani în urmă | 43824 ore |
| 1994-01-01T00:00:00.000Z | 6 ani | 6 ani în urmă | 52584 ore |
小时折算基于真实日历计算(闰年 8784 小时、平年 8760 小时,跨月/跨年的累计值各不相同),0 ore 表示不足 1 小时的截断结果。formatDistanceStrict 与 formatDistance 共用同一套 词汇表,因此单复数形式(lună/luni、oră/ore)与前后缀规则(în … / … în urmă)保持一致。
formatRelative 快照
基准时刻:now 为 2000 年 1 月 1 日 00:00(周六):
| 日期 | 结果 |
|---|---|
| 2000-01-10T00:00:00.000Z | 10.01.2000 |
| 2000-01-05T00:00:00.000Z | miercuri viitoare la 00:00 |
| 2000-01-02T00:00:00.000Z | mâine la 00:00 |
| 2000-01-01T00:00:00.000Z | astăzi la 00:00 |
| 1999-12-31T00:00:00.000Z | ieri la 00:00 |
| 1999-12-27T00:00:00.000Z | luni trecută la 00:00 |
| 1999-12-21T00:00:00.000Z | 21.12.1999 |
模板定义于 formatRelative/index.ts:lastWeek 用 eeee 'trecută la' p("上周 X"),yesterday 为 'ieri la' p,today 为 'astăzi la' p,tomorrow 为 'mâine la' p,nextWeek 用 eeee 'viitoare la' p("下周三"),超出该范围的回退为 P(dd.MM.yyyy)。la 是罗马尼亚语表示"在某个时刻"的介词。
formatDuration 快照
formatDuration 把 Duration 对象按从大到小的单位拼接输出,0 值单位也会显式输出:
| Duration | 结果 |
|---|---|
| {"years":0} | 0 ani |
| {"years":1} | 1 an |
| {"years":2} | 2 ani |
| {"months":0} | 0 luni |
| {"months":1} | 1 lună |
| {"months":2} | 2 luni |
| {"weeks":0} | 0 săptămâni |
| {"weeks":1} | 1 săptămână |
| {"weeks":2} | 2 săptămâni |
| {"days":0} | 0 zile |
| {"days":1} | 1 zi |
| {"days":2} | 2 zile |
| {"hours":0} | 0 ore |
| {"hours":1} | 1 oră |
| {"hours":2} | 2 ore |
| {"minutes":0} | 0 minute |
| {"minutes":1} | 1 minut |
| {"minutes":2} | 2 minute |
| {"seconds":0} | 0 secunde |
| {"seconds":1} | 1 secundă |
| {"seconds":2} | 2 secunde |
formatDuration 依赖 formatDistance 的令牌体系(xYears/xMonths/xWeeks/xDays/xHours/xMinutes/xSeconds),因此单复数规则(0 ani、1 an、2 ani;1 lună/2 luni)与 formatDistance 词汇表 完全一致,快照逐单位验证了这一点。
从快照到源码:罗马尼亚语本地化的语法与实现要点
1. 性别敏感的复数选择
罗马尼亚语名词有性(阳性/阴性)且单复数形态不规律(zi→zile、oră→ore、săptămână→săptămâni)。实现上不采用通用复数规则,而是为每个距离令牌显式写出 one/other 两套字符串,由 formatDistance/index.ts 按 count === 1 精确分派。
2. 前后缀的方向语义
addSuffix 时,未来用前缀 în ,过去用后缀 în urmă,判定依据是 options.comparison > 0(见 formatDistance/index.ts)。这与 types.ts 中 FormatDistanceFnOptions.comparison 的 -1 | 0 | 1 约定对应。
3. 窄宽度的歧义代价
月份(I/M/A)与星期(m)的 narrow 形式因字母重叠而产生解析歧义,快照如实标出 Invalid Date。这是翻译质量与机器可解析性的权衡点,也是新增翻译时最容易踩的坑。
4. 解析能力的分层
formatLong 中的 full 时间模板含 zzzz 时区令牌,parse 不支持时区,故 ppp 及以上组合在快照中全部 Errored;match 模块(match/index.ts)的 defaultMatchWidth: "wide" 与 defaultParseWidth: "any" 决定了哪些宽度可被反向解析。理解这一分层,就能预判"格式化成功但解析失败"的所有场景。
5. 周起始与周编号
ro 的 weekStartsOn: 1 与 firstWeekContainsDate: 1(index.ts)解释了 wo/Yo 快照行:2019-01-01(周二)属于 2018 年第 1 周起点所在的周,parse 后得到 2018-12-31;而 ISO 周(Io)在 2019 年恰好重合,输出相同。
结语:如何利用这份快照
snapshot.md 的价值在于它是"可验证的事实层":任何使用 ro locale 的 format/parse/formatDistance*/formatRelative/formatDuration 调用,其输出都应与上表一致。读者既可以把它当作罗马尼亚语日期格式的速查手册,也可以在修改或贡献 locale 时将其作为回归基准——改完 _lib 下的任一文件后,重新运行快照对比,即可定位到受影响的令牌与宽度。若要继续深入,可通读 locale 接口定义 与 ro 入口,或对照其他 locale 目录(如 en-US)理解同一契约下的不同语言实现。