开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载导读IDateToOrdinalWordConverter是 Humanizer 中负责把日期DateTime转换为本地化序数词日期Ordinal Words的扩展点接口是ToOrdinalWords()扩展方法全部能力的底层契约。本文以该接口为骨架结合仓库中默认实现、模式化转换器、注册表与测试用例讲清它的两个Convert方法签名、各文化下的真实输出规则、语法格GrammaticalCase的作用边界以及如何在Configurator上自定义自己的转换器。接口概览它解决什么问题在 Humanizer 中把DateTime变成1st of January, 2023这类人类可读日期文本的能力被抽象为IDateToOrdinalWordConverter接口。官方文档对该接口的定义只有一句话The interface used to localise the ToOrdinalWords method用于本地化ToOrdinalWords方法的接口但它的背后牵动着一整套按文化culture注册、按日历解析、按月名属格替换的实现体系。接口完整签名如下摘自 src/Humanizer/Localisation/DateToOrdinalWords/IDateToOrdinalWordConverter.csnamespace Humanizer; public interface IDateToOrdinalWordConverter { string Convert(DateTime date); string Convert(DateTime date, GrammaticalCase grammaticalCase); }接口包含两个方法方法说明参数返回值Convert(DateTime date)将日期转换为序数词日期文本date待格式化的DateTime本地化序数日期字符串Convert(DateTime date, GrammaticalCase grammaticalCase)使用指定语法格转换日期dategrammaticalCase目标语法格如 Nominative、Genitive 等本地化序数日期字符串第二个重载的存在是为了支持俄语、波兰语等有格变case system的语言同一个日期在不同的语法语境下主格、属格……需要输出不同的词形。对英语这类没有格变的语言该参数不产生效果。语法格的完整枚举定义见 Humanizer.GrammaticalCase。调用链从扩展方法到接口接口并不是直接暴露给使用者的 API日常编码中你调用的是DateToOrdinalWordsExtensions提供的扩展方法src/Humanizer/DateToOrdinalWordsExtensions.cspublic static string ToOrdinalWords(this DateTime input) Configurator.DateToOrdinalWordsConverter.Convert(input); public static string ToOrdinalWords(this DateTime input, GrammaticalCase grammaticalCase) Configurator.DateToOrdinalWordsConverter.Convert(input, grammaticalCase);即ToOrdinalWords()→Configurator.DateToOrdinalWordsConverter→ 按当前文化解析出的具体IDateToOrdinalWordConverter实现 →Convert。Configurator内部持有注册表并按文化解析src/Humanizer/Configuration/Configurator.cspublic static LocaliserRegistryIDateToOrdinalWordConverter DateToOrdinalWordsConverters { get; } new DateToOrdinalWordsConverterRegistry(); internal static IDateToOrdinalWordConverter DateToOrdinalWordsConverter DateToOrdinalWordsConverters.ResolveForCulture(null);ResolveForCulture(null)表示用当前线程的CultureInfo.CurrentCulture决定选用哪个文化的实现这正体现了 Humanizer 跟着当前文化走的本地化设计。默认实现DefaultDateToOrdinalWordConverter所有文化在未注册专门实现时的兜底转换器是DefaultDateToOrdinalWordConvertersrc/Humanizer/Localisation/DateToOrdinalWords/DefaultDateToOrdinalWordConverter.cs其内部逻辑清晰地区分了英语与非英语两条路径英语路径真正的序数词return date.Day.Ordinalize() date.ToString( MMMM yyyy);即把日部分做序数化1→1st、2→2nd、22→22nd再接上 MMMM yyyy格式的月与年。因此new DateTime(2023, 1, 1).ToOrdinalWords()→1st of January, 2023new DateTime(2020, 12, 22).ToOrdinalWords()→22nd of December, 2020以上示例同时见于扩展方法的 XML 注释与扩展方法签名所在的源码文件中。非英语路径短日期 方向标记清洗var culture CultureInfo.CurrentCulture; if (culture.TwoLetterISOLanguageName ! en) { return SanitizeNonEnglishDate(date.ToString(d, culture)); } static string SanitizeNonEnglishDate(string value) value.Replace(LeftToRightMark.ToString(), string.Empty) .Replace(RightToLeftMark.ToString(), string.Empty) .Replace(ArabicLetterMark.ToString(), string.Empty);要点有二直接使用当前文化的短日期模式d——因为非英语文化本身已经知道如何排列日期的年月日顺序Humanizer 不再强行改写成序数词短语剥离嵌入的方向控制符希伯来语、阿拉伯语等日历在短日期输出中可能嵌入左到右标记U200E、右到左标记U200F和阿拉伯字母标记U061C。这些标记一旦混入更大的序数短语文本会造成阅读混乱因此默认实现统一清除。语法格重载英语下被忽略第二个Convert(DateTime, GrammaticalCase)在默认实现中直接转发给单参版本public virtual string Convert(DateTime date, GrammaticalCase grammaticalCase) Convert(date);这与扩展方法文档中的说明一致grammaticalCase参数主要服务于有格变的语言对英语无效。需要注意默认实现不感知语法格——真正按语法格输出不同词形的是各个语言专门注册的模式化转换器。模式化实现OrdinalDatePattern 与 PatternDateToOrdinalWordsConverter大量语言并不使用兜底逻辑而是通过 Source Generator 依据 yml 语言资源生成专门的转换器注册。这些转换器大多继承DefaultDateToOrdinalWordConverter但覆写Convert以使用预构建的模式对象src/Humanizer/Localisation/DateToOrdinalWords/PatternDateToOrdinalWordsConverter.csclass PatternDateToOrdinalWordsConverter(OrdinalDatePattern pattern) : DefaultDateToOrdinalWordConverter { public override string Convert(DateTime date) pattern.Format(date); }日分量渲染模式OrdinalDateDayModeOrdinalDatePattern支持 5 种日分量渲染方式src/Humanizer/Localisation/DateToOrdinalWords/OrdinalDatePattern.cs模式行为Numeric日分量按文化感知的数字输出Ordinal日分量输出为序数词OrdinalWhenDayIsOne除非是每月 1 日输出序数否则输出数字MasculineOrdinalWhenDayIsOne每月 1 日输出阳性序数形式服务于有语法性别的语言DotSuffix数字后追加圆点后缀如某些中欧语言的25.写法日历模式OrdinalDateCalendarMode模式对象还控制日历解析方式src/Humanizer/Localisation/DateToOrdinalWords/OrdinalDateCalendarMode.csGregorian无论文化的默认日历是什么强制使用本地化格里高利历GregorianCalendar(GregorianCalendarTypes.Localized)失败时回退到OptionalCalendars中的格里高利历Native保留文化默认日历如泰国佛历、希伯来历、波斯历让DateTime.ToString()输出本地化的年份。月名属格替换OrdinalDatePattern内还实现了对模板中首个未转义MMMM的替换逻辑当日说明符d/dd注意不是ddd/dddd星期说明符紧邻月名说明符时会启用属格genitive月名数组monthsGenitive以支持俄语、波兰语等斯拉夫语系在25 мая这类搭配中月名发生格变的现象同时支持希吉来历Hijri / UmAlQura的专用月名数组。所有输出在返回前同样经过方向控制符清洗。注册与自定义LocaliserRegistry 与 Configurator默认注册表在 src/Humanizer/Configuration/DateToOrdinalWordsConverterRegistry.cs 中定义class DateToOrdinalWordsConverterRegistry : LocaliserRegistryIDateToOrdinalWordConverter { public DateToOrdinalWordsConverterRegistry() : base(_ new DefaultDateToOrdinalWordConverter()) DateToOrdinalWordsConverterRegistryRegistrations.Register(this); }基类构造参数_ new DefaultDateToOrdinalWordConverter()是兜底工厂任何没有显式注册的文化都会解析到默认实现DateToOrdinalWordsConverterRegistryRegistrations.Register(this)是由 Source Generator 生成的静态注册方法为各语言写入其专属转换器生成输入模型见 src/Humanizer.SourceGenerators/Generators/ProfileCatalogs/OrdinalDateProfileCatalogInput.cs。若要自定义某个文化的日期序数词输出可向Configurator暴露的注册表注册自定义实现// 将自定义转换器应用到某个特定文化 Configurator.DateToOrdinalWordsConverters .RegisterMyCulture(() new MyCustomDateToOrdinalWordConverter());自定义转换器只需实现IDateToOrdinalWordConverter的两个Convert方法对于仅需微调格式的场景继承DefaultDateToOrdinalWordConverter并覆写单参Convert即可GrammaticalCase重载默认仍会转发到你覆写的方法上。配套能力DateOnly 支持除DateTime外Humanizer 还为 .NET 6 提供了DateOnly的序数词转换走的是平行的IDateOnlyToOrdinalWordConverter接口与DateOnlyToOrdinalWordsConverters注册表见 src/Humanizer/DateToOrdinalWordsExtensions.cs 中#if NET6_0_OR_GREATER分支并通过PatternDateOnlyToOrdinalWordsConverter、DefaultDateOnlyToOrdinalWordConverter等实现类复用同一套模式逻辑src/Humanizer/Localisation/DateToOrdinalWords/。OrdinalDatePattern为此专门提供了Format(DateOnly)重载。测试验证各语言输出有据可查仓库测试目录中有大量针对ToOrdinalWords的语言级测试可当作行为规格书使用。例如斯瓦希里语测试tests/Humanizer.Tests/Localisation/sw/SwahiliDateToOrdinalWordsTests.cs[UseCulture(sw)] public class SwahiliDateToOrdinalWordsTests { [Theory] [InlineData(2022, 1, 25, 25 Januari 2022)] [InlineData(2015, 2, 3, 3 Februari 2015)] public void DateTimeToOrdinalWords_UsesSwahiliDatePattern(int year, int month, int day, string expected) { Assert.Equal(expected, new DateTime(year, month, day).ToOrdinalWords()); } }可以看到在sw文化下输出既不是英语的25th of January风格也不是数字序列而是25 Januari 2022——这正是模式化转换器按语言资源格式化后的结果。类似的语言级测试还覆盖了 Hausa、Igbo、Punjabi、Hindi、Nepali、Somali、Urdu 等分布在 tests/Humanizer.Tests/Localisation/ 对应子目录。公共 API 面含IDateToOrdinalWordConverter的公开签名则由 API 审批测试锁定见 tests/Humanizer.Tests/ApiApprover/PublicApiApprovalTest.Approve_Public_Api.DotNet8_0.verified.txt。小结IDateToOrdinalWordConverter虽只暴露两个Convert方法却是 Humanizer 日期本地化体系的最小契约它连接了面向用户的ToOrdinalWords()扩展、按文化解析的LocaliserRegistry、默认兜底的DefaultDateToOrdinalWordConverter以及由 Source Generator 驱动、支持语法格与属格月名的OrdinalDatePattern模式体系。理解这个接口就等于拿到了定制任意语言日期序数词输出的钥匙改一个实现类、注册一次文化ToOrdinalWords()的输出便随之改变。赞分享开发工具【免费下载链接】HumanizerHumanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities项目地址https://gitcode.com/gh_mirrors/hu/Humanizer点击查看免费下载相关推荐Humanizer 的 IDateToOrdinalWordConverter日期转序数词文本的本地化转换接口解析Humanizer 的 IDateToOrdinalWordConverter日期转序数词文本的本地化转换接口解析 IDateToOrdinalWordCon开发工具Humanizer 的 IDateToOrdinalWordConverter 接口定制本地化日期序数词转换的完整指南Humanizer 的 IDateToOrdinalWordConverter 接口定制本地化日期序数词转换的完整指南 导读 IDateToOrdinalWo开发工具Humanizer 本地化日期序数词转换IDateOnlyToOrdinalWordConverter 接口全解Humanizer 本地化日期序数词转换IDateOnlyToOrdinalWordConverter 接口全解 在 Humanizer 中把日期如 20开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
TypeDoc @readonly 标签详解：将可写成员标记为文档只读 开发工具文档 【免费下载链接】typedoc Documentation generator for TypeScript projects. 项目地址： https://gitcode.com/gh_mirrors/ty/typedoc 点击查看 免费下载 导读
readonly 是 TypeDoc 提供的一组修饰符标签（Modifier Tag）之一&a… · 2026/9/26 7:41:19
晋级答辩复盘，别再让录音躺死在手机里 又是一年职级晋升季。我自己做过十年技术团队管理，也参与过几十场内部答辩评审，每次答辩结束，最让我感慨的不是候选人的技术水平，而是复盘这个环节——几乎所有人都做得不够好。答辩现场慷慨激昂，评委提问犀利深入&… · 2026/9/26 7:41:13
AI代理数据泄露：责任归因与检测治理实战 1. 当"作案者"不是人：这起报告为什么让安全圈集体沉默西班牙这起数据泄露报告之所以值得单独拿出来聊，不是因为它造成了多大的实际损失，而是因为它第一次把一个此前只存在于理论推演里的问题，硬生生摆到了监管和取证桌面… · 2026/9/26 7:41:13
AgentScope 2.0：多智能体编排与RAG服务化的工程实践指南 1. 这个系统到底牛在哪我先说结论：AgentScope 是我近两年见过的把“多智能体编排”这件事做得最省心的开源框架，没有之一。尤其是 2.0 版本之后，它把 Java 生态、RAG 服务化、多 Agent 协作这些原本要自己拼装的零件，直接打包成了… · 2026/9/26 8:18:52
AI预畸变补偿：解决曲面热转印图案拉伸畸变，提升量产良率 曲面转印和热转印这行，图案拉伸畸变是个绕不开的老大难问题。平面转印还好说，一旦碰到带弧度、带凹凸、带球面的工件，图案贴上去不是被拉长就是被压扁，边缘还会出现波浪状的褶皱。我见过太多工厂在这个环节良率卡在六七成上不去&a… · 2026/9/26 8:18:52
UVa 12039 Goldbach‘s Cardinality 题目描述
Goldbach’s Cardinality\texttt{Goldbachs Cardinality}Goldbach’s Cardinality（哥德巴赫基数）GC(n)\textit{GC}(n)GC(n) 定义为偶数 nnn 能够表示为 两个不同素数之和 的不同方式数。
例如：307231119131730 7 23 11 19 13 … · 2026/9/26 8:18:52
具身智能面试必备：Flow Matching原理、Action Expert设计与部署实战 1. 具身智能面试为什么绕不开 Flow Matching这两年具身智能方向的面试，但凡涉及到动作生成、策略学习、VLA（Vision-Language-Action）模型，Flow Matching 几乎是一个绕不过去的话题。我在过去一年里陆续面了七八家做具身智能的公司… · 2026/9/26 8:18:52
如何阻止 AI 编造参考文献？ARS 防泄漏协议 4 道防线 + 2 个标记机制完整指南 如何阻止 AI 编造参考文献？ARS 防泄漏协议 4 道防线 2 个标记机制完整指南 【免费下载链接】academic-research-skills Academic Research Skills for Claude Code: research → write → review → revise → finalize 项目地址: https://gitcode.com/GitHub_Tr… · 2026/9/26 8:18:46
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
