企业官网建设流程全解析

date-fns 德语（奥地利）de-AT 语言环境完全指南：format/parse 令牌、相对时间与本地化实现解析

【免费下载链接】date-fns⏳ Modern JavaScript date utility library ⌛️项目地址: https://gitcode.com/gh_mirrors/da/date-fns

本文以 date-fns 仓库中pkgs/core/src/locale/de-AT/snapshot.md（德语奥地利区语言环境的官方行为快照）为核心，系统讲解 de-AT 语言环境下format、parse、formatDistance、formatDistanceStrict、formatRelative、formatDuration六大函数的实际输出规则，并对照pkgs/core/src/locale/de-AT/与pkgs/core/src/locale/de/下的真实源码，说明「Jänner」「vorm. / nachm.」「1. Quartal」等奥地利特有写法背后的实现原理与配置方式。读完本文，你将能够准确预测 de-AT 环境下每个令牌的格式化结果，理解本地化数据的组织方式，并能在自己的项目中正确导入与使用deAT语言环境。

一、de-AT 语言环境在 date-fns 中的定位

de-AT（德语–奥地利）是 date-fns 多语言支持体系中的一员。在仓库中，该语言环境由 pkgs/core/src/locale/de-AT/index.ts 定义并导出，同时通过 pkgs/core/src/locale/index.ts#L22 中的export * from "./de-AT/index.ts"被统一汇总到date-fns/locale入口。

从源码结构上看，de-AT 并不是从零编写的一整套独立实现，而是「复用 de 语言环境的通用部分 + 覆写奥地利特有部分」的组合式实现。这一点在 de-AT/index.ts 中体现得非常明显：

import { formatDistance } from "../de/_lib/formatDistance/index.ts"; import { formatLong } from "../de/_lib/formatLong/index.ts"; import { formatRelative } from "../de/_lib/formatRelative/index.ts"; import { match } from "../de/_lib/match/index.ts"; import type { Locale } from "../types.ts"; // difference to 'de' locale import { localize } from "./_lib/localize/index.ts"; export const deAT: Locale = { code: "de-AT", formatDistance: formatDistance, formatLong: formatLong, formatRelative: formatRelative, localize: localize, match: match, options: { weekStartsOn: 1 /* Monday */, firstWeekContainsDate: 4, }, };

可以看到，de-AT 与 de 的核心差异集中在localize（本地化词表）上——尤其是 1 月写作Jänner、缩写为Jän.，以及上午/下午使用vorm. / nachm.等奥地利用法。距离、长格式、相对时间与匹配解析则直接复用 de 的实现。options中的weekStartsOn: 1（周一为一周起点）与firstWeekContainsDate: 4（一年第一周须包含 1 月 4 日）与德国本地历法规则一致，与快照中「Local week-numbering year」等计算结果一一对应。

二、snapshot.md 是什么：语言环境行为的「黄金基准」

每个语言环境目录下都有一份snapshot.md（如 de-AT/snapshot.md、de/snapshot.md）。它由脚本对真实函数执行结果快照生成，记录了该语言环境下全部相关函数的预期输出，是校对本地化数据、回归测试与文档参考的权威依据。本文后续所有结果均取自该快照，可直接当作断言来使用。

快照整体结构分为六大部分，覆盖六类函数：

下文逐一展开。

三、format与parse：de-AT 令牌行为全景

快照第一部分以「令牌字符串 × 输入日期 → format 结果 → parse 结果」的表格形式，逐一给出 de-AT 环境下每个令牌的预期输出。parse列为空串时表示该令牌在解析阶段不可用，Invalid Date表示无法唯一解析（如下文的单字母星期几），Errored表示该长格式包含时区文本而无法解析。

3.1 年份与季度

注意Yo（本地周编号年份）与yo（日历年份）在跨年边界处结果不同：快照中 0005-01-01 按Yo输出4.并解析回 0003-12-29，这正是firstWeekContainsDate: 4与周一起始共同作用的结果。

3.2 月份：奥地利写法的核心差异区

de-AT 与 de 最大的差异在 1 月：

快照中 3 月的缩写输出为März（无句点，保留完整词形），5 月Mai、6 月Juni、7 月Juli在缩写与全称中同形。这些数据的来源即 de-AT/_lib/localize/index.ts 中的monthValues与formattingMonthValues：

const monthValues = { narrow: ["J", "F", "M", "A", "M", "J", "J", "A", "S", "O", "N", "D"] as const, abbreviated: ["Jän", "Feb", "Mär", "Apr", "Mai", "Jun", "Jul", "Aug", "Sep", "Okt", "Nov", "Dez"] as const, wide: ["Jänner", "Februar", "März", "April", "Mai", "Juni", "Juli", "August", "September", "Oktober", "November", "Dezember"] as const, }; // https://st.unicode.org/cldr-apps/v#/de_AT/Gregorian/ const formattingMonthValues = { narrow: monthValues.narrow, abbreviated: ["Jän.", "Feb.", "März", "Apr.", "Mai", "Juni", "Juli", "Aug.", "Sep.", "Okt.", "Nov.", "Dez."] as const, wide: monthValues.wide, };

关键点在于：

• monthValues（独立式 standalone）缩写不带句点：Jän、Feb；formattingMonthValues（格式化 context）缩写带句点：Jän.、Feb.，这正是快照中MMM输出Jän.而LLL输出Jän的原因；
• 源码注释表明词表参考自 Unicode CLDR 的de_ATGregorian 数据（仓库中保留了https://st.unicode.org/cldr-apps/v#/de_AT/Gregorian/这一数据来源链接）；
• 代码注释还特别提醒：德语中星期与月份需要首字母大写，且格式化结果应像处于句子中间那样自然（与西班牙语小写约定相反）。

3.3 星期几

快照中值得注意的细节：单字母窄式EEEEE/iiiii/eeeee/ccccc在解析时对「M」（Montag）返回Invalid Date，因为单字母无法在多个 M 开头星期（Montag、Mittwoch）间唯一确定；而 2019-02-15 的F（Freitag）可解析。这是快照对解析歧义性的如实记录，提醒开发者：窄式令牌更适合格式化而非解析。

星期词表同样定义在 de-AT/_lib/localize/index.ts 的dayValues中（So./Mo./Di....与Sonntag/Montag/...），de-AT 与 de 在此保持一致。

3.4 上午/下午与弹性时段

de-AT 的 AM/PM 使用奥地利特有的缩写：

弹性时段令牌B系列按一天中的时间段输出：

快照同时记录了 parse 侧的边界行为：B缩写系列解析 14:13 时返回Invalid Date，而全称BBBB可解析为当天 12:00——说明弹性时段的缩写解析存在歧义，建议解析场景使用全称。这些词表定义在 de-AT/_lib/localize/index.ts 的dayPeriodValues与formattingDayPeriodValues中（narrow 用vm./nm.，缩写用vorm./nachm.，wide 用vormittags/nachmittags）。

3.5 小时、分钟、秒与日期序号

de-AT 的序数规则非常统一：所有序数均为「数字 + 句点」，无性别/格变化，这是由 de-AT/_lib/localize/index.ts 中的ordinalNumber实现保证的：

const ordinalNumber: LocalizeFn<number> = (dirtyNumber) => { const number = Number(dirtyNumber); return number + "."; };

3.6 长本地化日期P/PP/PPP/PPPP

长日期令牌由 de/_lib/formatLong/index.ts 定义（de-AT 复用），格式遵循 DIN 5008 日期规范（源码注释引用了该标准）：

const dateFormats = { full: "EEEE, do MMMM y", // Montag, 7. Januar 2018 long: "do MMMM y", // 7. Januar 2018 medium: "do MMM y", // 7. Jan. 2018 short: "dd.MM.y", // 07.01.2018 };

实际输出（结合 de-AT 词表）：

快照还验证了 1453 年等历史日期（29.05.1453、Sonntag, 29. Mai 1453）的格式化与解析均正常。

3.7 长本地化时间与日期时间组合

时间格式定义在同一文件：

const timeFormats = { full: "HH:mm:ss zzzz", long: "HH:mm:ss z", medium: "HH:mm:ss", short: "HH:mm", }; const dateTimeFormats = { full: "{{date}} 'um' {{time}}", long: "{{date}} 'um' {{time}}", medium: "{{date}} {{time}}", short: "{{date}} {{time}}", };

快照明确标注：任何含GMT时区文本的长时间格式（ppp及以上）在parse时一律返回Errored——这是快照文档对解析边界条件的如实记录，提醒开发者格式化时若需后续解析，应避免使用带时区文本的full/long宽度。

四、formatDistance：模糊距离的奥地利德语表达

快照第二节假设「现在是 2000 年 1 月 1 日 00:00」，给出formatDistance的预期输出，覆盖三种组合：默认、includeSeconds: true、addSuffix: true。节选关键行为：

要点：

• 未来时间加前缀in，过去时间加前缀vor；
• includeSeconds仅影响不足 1 分钟时的细分输出（5/10/20 秒、半分钟）；
• 单数用1 Jahr、1 Tag、1 Monat，复数用Jahre、Tage、Monate。

实现位于 de/_lib/formatDistance/index.ts，其核心设计是每个距离令牌同时提供standalone（独立）与withPreposition（带介词）两套词形：

xDays: { standalone: { one: "1 Tag", other: "{{count}} Tage" }, withPreposition: { one: "1 Tag", other: "{{count}} Tagen" }, },

当addSuffix: true时使用withPreposition（14 Tagen第三格），否则使用standalone（14 Tage）。最终前缀逻辑：

if (options?.addSuffix) { if (options.comparison && options.comparison > 0) { return "in " + result; } else { return "vor " + result; } }

comparison由调用方（如formatDistanceToNow）根据目标日期在过去还是未来传入-1/1，从而决定in/vor。

五、formatDistanceStrict：精确距离与强制单位

快照第三节同样以 2000-01-01 00:00 为基准，展示formatDistanceStrict的输出，重点列包含第三列「强制单位（如 hour）」：

与formatDistance不同，formatDistanceStrict不做四舍五入式的模糊化（45 分钟就是45 Minuten），且可通过unit选项强制以某单位表达（45 分钟按小时计为1 Stunde，15 分钟按小时计为0 Stunden）。addSuffix同样使用withPreposition词形。

六、formatRelative：相对日期的地道表达

快照第四节以「现在是 2000-01-01 00:00」为基准：

实现位于 de/_lib/formatRelative/index.ts：

const formatRelativeLocale = { lastWeek: "'letzten' eeee 'um' p", yesterday: "'gestern um' p", today: "'heute um' p", tomorrow: "'morgen um' p", nextWeek: "eeee 'um' p", other: "P", };

其中other回退为长日期P（dd.MM.y），所以超出相对窗口的日期显示为10.01.2000、21.12.1999。

七、formatDuration：时长对象的本地化

快照最后一节给出formatDuration对Duration对象的输出：

同时{"years":0}等零值输出为0 Jahre、0 Monate、0 Wochen、0 Tage、0 Stunden、0 Minuten、0 Sekunden（零值默认不省略）。formatDuration的本地化同样依赖formatDistance词表中的xYears/xMonths等令牌，因此单复数变化（Jahr/Jahre、Monat/Monate、Tag/Tage、Stunde/Stunden）与第四、五节完全一致。

八、在项目中导入并使用 de-AT 语言环境

de-AT 通过 pkgs/core/src/locale/index.ts#L22 的export * from "./de-AT/index.ts"暴露为deAT。使用方式与 i18n.md 描述的通用流程一致——显式导入 locale 并作为locale选项传入：

import { format, formatDistance, parse } from "date-fns"; import { deAT } from "date-fns/locale"; // 格式化：奥地利德语月份写法 format(new Date(2019, 0, 11), "do MMMM y", { locale: deAT }); //=> '11. Jänner 2019' // 相对时间：带 in/vor 前缀 formatDistance(new Date(2000, 5, 1), new Date(2000, 0, 1), { locale: deAT }); //=> '5 Monate' // 解析：奥地利缩写可被正确识别（match 复用 de 实现，兼容 Jän./Jan. 变体） parse("11. Jänner 2019", "do MMMM y", new Date(), { locale: deAT });

从 de/_lib/match/index.ts 的正则可以看到，月份匹配对j[aä]n（同时接受 Jän/Jän. 与 Jan/Jan.）、mär[z]?（März/Mär）等做了兼容处理，因此解析时奥地利与德国写法均可被识别；星期匹配(son?|mon?|die?|mit?|don?|fre?|sam?)\.?同样容忍带/不带句点的形式。

九、快照的工程价值：如何验证与扩展

snapshot.md 在 date-fns 的语言环境开发流程中承担「行为基准」角色：

1. 回归基准：修改localize、match等词表后，重跑快照即可比对输出是否发生变化，防止破坏既有格式化结果；
2. 文档参考：所有令牌的组合行为（含Invalid Date、Errored等边界）都以真实运行结果为据，无需阅读源码即可确定预期；
3. 解析能力清单：parse列直接展示哪些格式可以双向转换、哪些仅能格式化，是选择令牌时的实用指南。

对想要在 de-AT 基础上定制（例如新建瑞士德语de-CH或其他变体）的开发者，仓库中的组合式结构提供了清晰的范本：复用相邻语言环境的formatDistance/formatLong/formatRelative/match，只需按 de-AT/_lib/localize/index.ts 的方式重写localize词表，并在 locale 类型定义（Locale接口含code、formatDistance、formatRelative、localize、formatLong、match、options）的约束下组装导出即可。语言环境选项（weekStartsOn、firstWeekContainsDate）则决定了星期与周编号类令牌的计算基准，与快照中Yo、wo、Io的输出直接相关。

十、快速参考：de-AT 关键差异速查表

综上，de-AT/snapshot.md 是一份可运行的「行为契约」：它既完整记录了 de-AT 环境下六类日期函数的全部输出规则，又与 de-AT/index.ts、de-AT/_lib/localize/index.ts 等源码相互印证。开发者在实现奥地利德语界面时，可将其作为格式化与解析的权威参照，并据此快速定位「Jänner」「vorm./nachm.」「1. Quartal」等本地化细节的代码出处。

【免费下载链接】date-fns⏳ Modern JavaScript date utility library ⌛️项目地址: https://gitcode.com/gh_mirrors/da/date-fns