Humanizer 本地化接口 `IDateOnlyToOrdinalWordConverter` 深度解析:DateOnly 序数词日期的转换机制与自定义实现

发布时间:2026/11/19 8:10:48

Humanizer 本地化接口 `IDateOnlyToOrdinalWordConverter` 深度解析:DateOnly 序数词日期的转换机制与自定义实现 开发工具【免费下载链接】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点击查看免费下载IDateOnlyToOrdinalWordConverter是 Humanizer 中负责把 .NET 6 的System.DateOnly值转换为本地化序数词日期Ordinal Words文本的核心抽象接口支撑着DateOnly.ToOrdinalWords()扩展方法的全部行为。本文以该接口的官方 API 参考文档为主体结合 Humanizer 仓库中的接口定义、默认实现、注册表机制与测试用例系统讲解其方法签名、底层原理、文化差异处理以及如何自定义实现帮助你在自己的 .NET 项目中精确控制日期序数词的输出格式。接口概述它解决什么问题在文档 Humanizer.Localisation.DateToOrdinalWords.IDateOnlyToOrdinalWordConverter 中该接口被定义为The interface used to localise the ToOrdinalWords method.也就是说它专门服务于ToOrdinalWords的本地化当你在英语环境下调用new DateOnly(2023, 1, 1).ToOrdinalWords()得到1st of January, 2023时真正干活的就是当前文化所解析出的IDateOnlyToOrdinalWordConverter实现见 DateToOrdinalWordsExtensions.cs 中Configurator.DateOnlyToOrdinalWordsConverter.Convert(input)的调用链。接口的完整签名在仓库源码 IDateOnlyToOrdinalWordConverter.cs 中定义并且整个类型被#if NET6_0_OR_GREATER条件编译包裹——因为DateOnly类型本身从 .NET 6 才开始引入。也就是说该接口只在 .NET 6 及以上目标框架中可用这与扩展方法 DateToOrdinalWordsExtensions.cs 中的同款条件编译保持严格一致。#if NET6_0_OR_GREATER namespace Humanizer; /// summary /// Converts dates into the localized text used by cToOrdinalWords/c. /// /summary public interface IDateOnlyToOrdinalWordConverter { string Convert(DateOnly date); string Convert(DateOnly date, GrammaticalCase grammaticalCase); } #endif值得注意的是Humanizer 同时还存在一个面向DateTime的姊妹接口IDateToOrdinalWordConverter见 IDateToOrdinalWordConverter.cs两者的方法形状完全对称区别仅在于输入参数类型。IDateOnlyToOrdinalWordConverter是为现代 .NET 的纯日期类型单独设计的专用契约。Convert(DateOnly)基础转换方法签名与语义string Convert(System.DateOnly date);文档对该方法的描述是 Converts the date to Ordinal Words即把给定日期转换为当前文化下的序数词日期字符串。参数date为System.DateOnly返回值是System.String。默认实现的行为差异Humanizer 提供的默认实现DefaultDateOnlyToOrdinalWordConverter见 DefaultDateOnlyToOrdinalWordConverter.cs非常巧妙地处理了英语与非英语两类文化的差异英语文化TwoLetterISOLanguageName en将日期中的日部分先做序数词化再拼接月份与年份例如date.Day.Ordinalize() date.ToString( MMMM yyyy)产出1st of January, 2023、22nd of December, 2020这样的结果非英语文化直接复用当前文化自己的短日期模式date.ToString(d, culture)因为很多语言本身已经内置了正确的日期排序与本地化格式Humanizer 不需要额外干预。方向性控制符的清理非英语路径还有一个容易被忽略的细节某些日历尤其是 RTL 语言环境在短日期输出中会嵌入 Unicode 方向性控制符例如U200ELeft-To-Right Mark、U200FRight-To-Left Mark和U061CArabic Letter Mark。默认实现中的SanitizeNonEnglishDate方法会把这些字符逐一剥离避免序数词日期被嵌入更大的短语时出现排版混乱。static string SanitizeNonEnglishDate(string value) value.Replace(LeftToRightMark.ToString(), string.Empty) .Replace(RightToLeftMark.ToString(), string.Empty) .Replace(ArabicLetterMark.ToString(), string.Empty);Convert(DateOnly, GrammaticalCase)带语法格的重载签名与语义string Convert(System.DateOnly date, Humanizer.GrammaticalCase grammaticalCase);文档描述为 Converts the date to Ordinal Words using the provided grammatical case。除date参数外本重载多出一个grammaticalCase参数类型为Humanizer.GrammaticalCaseAPI 参考文档中通过相对链接指向 Humanizer.GrammaticalCase.md。GrammaticalCase枚举的全貌GrammaticalCase.cs 中定义的枚举包含约 30 个成员覆盖了世界主要语言的格体系例如印欧语系常见格Nominative主格、Genitive属格、Dative与格、Accusative宾格、Instrumental工具格、Prepositional前置格等乌拉尔语系/亚非语系等特色格Partitive部分格、Vocative呼格、Illative入格、Adessive接格、Essive样格等南亚语言特有格Sociative、Benefactive等。该参数在什么情况下真正生效关键语义在扩展方法的 XML 文档中有明确说明见 DateToOrdinalWordsExtensions.csThe grammatical case parameter is primarily used by languages that have case systems. For languages without grammatical cases (like English), this parameter has no effect.也就是说grammaticalCase主要服务于俄语、波兰语、乌克兰语这类名词有格变化的语言在构建日期短语时需要根据句法位置选择正确的格形式而对于英语等没有格系统的语言传不传该参数结果完全一致。这一点在默认实现中体现得更为直接——DefaultDateOnlyToOrdinalWordConverter的双参数重载只是简单转发给单参数版本并明确注释grammaticalCase参数被忽略见 DefaultDateOnlyToOrdinalWordConverter.cspublic virtual string Convert(DateOnly date, GrammaticalCase grammaticalCase) Convert(date);注册与解析机制接口如何与文化和配置挂钩配置入口ConfiguratorHumanizer 把所有本地化组件都聚合在 Configurator.cs 中。其中与本文主题相关的有两个成员公开注册表public static LocaliserRegistryIDateOnlyToOrdinalWordConverter DateOnlyToOrdinalWordsConvertersConfigurator.cs内部解析快捷入口internal static IDateOnlyToOrdinalWordConverter DateOnlyToOrdinalWordsConverter它通过DateOnlyToOrdinalWordsConverters.ResolveForCulture(null)按当前文化解析出具体实现Configurator.cs。扩展方法ToOrdinalWords最终调用的正是这个内部属性因此改变CultureInfo.CurrentCulture或注册不同的转换器实现都会立即影响DateOnly.ToOrdinalWords()的输出。注册表默认行为DateOnlyToOrdinalWordsConverterRegistry.cs 中展示了注册表的构造逻辑class DateOnlyToOrdinalWordsConverterRegistry : LocaliserRegistryIDateOnlyToOrdinalWordConverter { public DateOnlyToOrdinalWordsConverterRegistry() : base(_ new DefaultDateOnlyToOrdinalWordConverter()) DateOnlyToOrdinalWordsConverterRegistryRegistrations.Register(this); }这里有两层含义其一基础工厂函数以DefaultDateOnlyToOrdinalWordConverter作为兜底其二DateOnlyToOrdinalWordsConverterRegistryRegistrations.Register(this)是源码生成器生成的注册代码会把各语言配置文件中声明的 profile 注册进去。源码生成器如何生成注册在 GenerationHelpers.cs 中可以看到生成器对DateOnlyToOrdinalWordsConverterRegistry的两种分支处理static string? CreateDateOnlyToOrdinalWords(string profile) profile default ? new DefaultDateOnlyToOrdinalWordConverter() : DateOnlyToOrdinalWordsProfileCatalog.Resolve( Quote(profile) );即当某个语言的配置 profile 为default时直接使用默认转换器否则通过DateOnlyToOrdinalWordsProfileCatalog按 profile 名称解析解析结果通常是基于OrdinalDatePattern构建的PatternDateOnlyToOrdinalWordsConverter。底层实现OrdinalDatePattern的格式化原理当某个语言配置了专门的日期序数词 pattern 时Humanizer 使用PatternDateOnlyToOrdinalWordsConverter完成转换见 PatternDateOnlyToOrdinalWordsConverter.cs它继承自默认转换器并重写Convert把格式化委托给OrdinalDatePattern.Format(date)。模式模板与占位符OrdinalDatePattern.cs 是这套机制的核心。其设计要点包括模板字符串中可以包含{day}占位符格式化完成后再替换为实际渲染的日文本占位符被替换为dDAY这种真实d说明符 标记的组合目的是让 .NET 的DateTimeFormatInfo看到一个日 月的完整模式从而在斯拉夫语系等语言中正确触发属格genitive月份名格式化后数字日与标记一起被剥离再插入渲染好的日文本SubstituteMonth方法会扫描格式串中第一个未转义的MMMM将其替换为语言包中声明的月份名数组支持普通与属格两套数组并遵循DateTimeFormatInfo的引号转义规则属格月份名的触发条件是日说明符d/dd非ddd/dddd紧邻月份说明符例如dDAY MMMM或MMMM d模式IsDayAdjacentToMonth与FindAdjacentDayOfMonth负责这项判定OrdinalDatePattern.cs。五种日渲染模式OrdinalDateDayMode枚举OrdinalDatePattern.cs决定了日期中日部分的呈现方式FormatDay方法OrdinalDatePattern.cs据此分派模式行为Numeric以文化感知的数字形式渲染日Ordinal渲染为序数词如英语1stOrdinalWhenDayIsOne除每月 1 号渲染序数词外其余用数字MasculineOrdinalWhenDayIsOne每月 1 号使用阳性序数词服务于有语法性别的语言DotSuffix数字后附加句点后缀如捷克语等语言的惯例写法日历模式的控制OrdinalDateCalendarMode枚举OrdinalDateCalendarMode.cs控制格式化的日历解析策略Gregorian无论文化默认日历如何强制使用本地化格里高利历Native使用文化的默认日历如泰历佛历、希伯来历、波斯历。OrdinalDatePattern.GetPatternCulture方法OrdinalDatePattern.cs负责实现这一策略Native模式下直接返回克隆的当前文化使DateTime.ToString()输出原生年份Gregorian模式则尝试把DateTimeFormat.Calendar切换为GregorianCalendar若失败则遍历OptionalCalendars寻找可用的格里高利历。测试验证与实际输出Humanizer 仓库中有大量针对DateOnly序数词转换的测试可以作为行为规范直接参考。以 SwahiliDateToOrdinalWordsTests.cs 为例斯瓦希里文化下日期被渲染为25 Januari 2022这样不带序数词标记的格式且DateTime与DateOnly两个扩展方法行为保持一致[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()); } #if NET6_0_OR_GREATER [Theory] [InlineData(2022, 1, 25, 25 Januari 2022)] [InlineData(2015, 2, 3, 3 Februari 2015)] public void DateOnlyToOrdinalWords_UsesSwahiliDatePattern(int year, int month, int day, string expected) { Assert.Equal(expected, new DateOnly(year, month, day).ToOrdinalWords()); } #endif }类似的测试还覆盖豪萨语、伊博语、索马里语等新近加入的语言见 HausaDateToOrdinalWordsTests.cs、IgboDateToOrdinalWordsTests.cs、SomaliDateToOrdinalWordsTests.cs它们共同验证了注册表解析 Pattern 格式化这条链路的正确性。如何自定义实现IDateOnlyToOrdinalWordConverter是公开接口你可以通过实现它来完全接管日期序数词的本地化输出典型场景包括为某个未覆盖的语言提供专属格式、对现有语言的输出做二次定制、或者在特殊日历下强制某种渲染风格。自定义实现的基本步骤如下实现接口实现Convert(DateOnly)与Convert(DateOnly, GrammaticalCase)两个方法。若不关心语法格双参数版本直接转发给单参数版本即可与默认实现的策略一致注册实现通过Configurator.DateOnlyToOrdinalWordsConverters注册表按文化注册你的实现。注册表基于LocaliserRegistryT会按当前文化解析合适的转换器保持与扩展方法的衔接注册完成后dateOnly.ToOrdinalWords()会自动路由到你的实现无需改动调用方代码。从源码结构可以推断Humanizer 对绝大多数语言的日期序数词支持都建立在默认实现 数据驱动的OrdinalDatePattern模板之上因此在实现自定义转换器之前优先检查目标语言是否已在src/Humanizer/Locales/目录的 YAML 语言包中声明了日期 pattern 模板通常是更省力且更符合项目生态的做法。小结IDateOnlyToOrdinalWordConverter是 Humanizer 本地化体系中专为 .NET 6DateOnly设计的核心契约它定义了日期 → 序数词日期文本的两个转换方法通过 Configurator.cs 与源码生成器驱动的注册表按文化解析具体实现背后由DefaultDateOnlyToOrdinalWordConverter的英语/非英语分流策略、OrdinalDatePattern的模板化格式化、属格月份名处理、日历模式选择与方向性控制符清理等一系列机制共同支撑。理解这个接口及其实现链路你就能在 .NET 项目中准确控制序数词日期的输出并在需要时以最小成本接入自定义本地化方案。赞分享开发工具【免费下载链接】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 本地化日期序数词转换IDateOnlyToOrdinalWordConverter 接口全解Humanizer 本地化日期序数词转换IDateOnlyToOrdinalWordConverter 接口全解 在 Humanizer 中把日期如 20开发工具MAA明日方舟助手一键跑完全部日常把 30 分钟重复劳动交给它MAA明日方舟助手一键跑完全部日常把 30 分钟重复劳动交给它 MAAMaaAssistantArknights是基于图像识别的《明日方舟》日常辅助工具开发工具Humanizer.IDateOnlyToOrdinalWordConverter 接口深度解析DateOnly 本地化序数日期转换Humanizer.IDateOnlyToOrdinalWordConverter 接口深度解析DateOnly 本地化序数日期转换 IDateOnlyToO开发工具上一篇在Obsidian中打造你的个人日程管理中心完整使用指南下一篇React Chrono富媒体集成图片、视频和YouTube嵌入完整教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/19 8:10:47

不会代码也能做站:Wordpress动图主题落地最佳实践

不会代码也能做站:Wordpress动图主题落地最佳实践 自己完全不懂代码,却想快速拥有一个视觉效果炸裂、能吸引眼球的企业官网或内容站,这确实是很多创业者和小团队负责人的噩梦。你不需要去啃晦涩的HTML和CSS,也不需要花几万块找外包团队被…

2026/11/19 15:55:56

Manim 中文显示问题报错解决办法

使用Manim直接制作这种动画视频的话是不支持中文的,需要进行一些修改,效果如图所示。 但是修改的方案都太坑,经过自己不断的研究找到了一个比较简单实用的方法。 文章目录 源文件修改 代码修改 源文件修改 实用everuthing找到ctex_template.tex文件。 我这里的路径是D:\M…

2026/11/19 23:15:15

电工证到底几年有效 内部消息透露考前必看

电工证到底几年有效 内部消息透露考前必看 怕考不过白交培训费?别急,老司机带你把关!最近接了个河南郑州的学员电话,说他花了一万五报了个电工证培训班,结果一查政策,发现这个证根本不合规,差点把钱打水漂。这种事真的不是个例,所以今天我来给你说个…

2026/11/19 23:15:15

怎么分辨几级电工证怎么网上查询靠谱信息

怎么分辨几级电工证怎么网上查询靠谱信息 你现在手里拿着一份电工证,但不知道这是几级证,眼看着岗位机会一个接一个错过,心里是不是急得不行?电工证分初级、中级、高级,直接影响你能不能干哪类活儿、拿多少工资, 急需特种作业证才能上岗找工作…

2026/11/19 23:15:15

0学历也能考职业资格证高级电工证?良心建议来了

0学历也能考职业资格证高级电工证?良心建议来了 学历不高怕报不上名?我来告诉你,0学历也能考职业资格证高级电工证,但不是所有人都是“生来就能考”。作为在应急管理领域干了十年的“老电工”,我见过太多人因为不了解政策、没找对方法,最后白忙一场。…

2026/11/19 23:15:15

高职电工证三级最新政策解读

30岁电工证三级考不过?网上查询最新政策帮你稳过实操考试 实操考试心里没底怕挂科,这几乎是所有准备考高职电工证三级的学员共同的焦虑。尤其是像洛阳这样的城市,房建工程从业者多,电工证是不少人的刚需,但很多人对考试流程、评分标准、报名条件一知半…

2026/11/19 23:15:15

电工证到底几年有效保姆级教程

电工证到底几年有效保姆级教程 之前考的证在外省能不能转过来?你不是一个人,这是很多特种作业持证人最关心的问题。特别是像你这样的漯河劳务班组负责人,经常要跨区域作业,证能不能顺利转移,直接关系到能否合规上岗。别急,这篇保姆级教程从证书有效期、…

2026/11/19 23:10:08

如何预防电工证被冒用到期换证流程

电工证被冒用怎么防?良心建议来了,别让证书过期耽误你发展 证书过期了不知道怎么复审延期?你不是一个人。在平顶山房建工程圈,很多电工因为不了解复审流程,导致证书过期被冒用,甚至丢了工作。这事儿真不是开玩笑的,尤其是现在行业监管越来越严,…

2026/11/19 22:14:34

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/19 0:04:42

深圳电工证培训考场模拟考试题库:郑州报考避坑指南

深圳电工证培训考场模拟考试题库:郑州报考避坑指南 证书过期了不知道怎么复审延期,很多人在遇到这个问题的时候才意识到特种作业证的重要性。其实,不管是电工证、焊工证还是高处作业证,这些证书不仅是上岗的“通行证”,更是法律对安全操作的硬性要求。尤…

2026/11/19 0:04:42

天津电工证查询入口多少钱能报上名

天津电工证查询入口多少钱能报上名 学历不高怕报不上名?别急,天津电工证查询入口其实没你想的那么难。今天咱们就来聊聊,怎么用最低的门槛、最少的钱,把电工证拿下来,还能查得到、用得上。 电工证到底值不值?先搞清楚它的作用…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/19 17:18:32

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑