date-fns 罗马尼亚语(ro)Locale 完整指南:format/parse 令牌快照与本地化实现解析

原创2026-09-18 21:56:131,913 阅读
文章标签:国际化跨平台前端

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)理解同一契约下的不同语言实现。

登录后查看全文
date-fns