Humanizer 流式日期 API 详解:On.August 类的全部成员、实现原理与实战用法

发布时间:2026/11/21 16:51:09

Humanizer 流式日期 API 详解:On.August 类的全部成员、实现原理与实战用法 开发工具【免费下载链接】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 的On静态类为 .NET 开发者提供了一套口语化的流式日期访问器fluent date accessors让你可以用On.August.The23rd这样接近自然语言的表达式直接获得当前年份的 8 月 23 日。本篇以On.August类为切入点逐一解析其全部 31 个静态属性与The(int)方法并结合源码揭示其由 T4 模板自动生成的实现机制、On与OnDate两个入口的差异以及实际使用中的注意事项帮助你彻底掌握 Humanizer 流式日期 API 的正确用法。一、类概览On.August 是什么On.August是 On 类 内部嵌套的一个公开类其唯一职责是提供 8 月August的流式日期访问器。官方 API 文档Humanizer.On.August.md中给出的类声明为public class On.August该类直接继承自System.Object本身不携带任何状态全部成员均为public static因此使用时不需要实例化直接通过On.August.xxx静态访问即可。类的官方摘要为Provides fluent date accessors for August即为 8 月提供流式日期访问器。从源码角度看On是一个容器类内部为一年 12 个月各嵌套了一个同名字类January、February、…、DecemberAugust只是其中之一。完整的生成代码位于 On.Days.cs约第 1370 行开始是August类的定义。二、31 个静态属性The1st 到 The31st 完整清单On.August的核心成员是 31 个静态只读属性分别对应 8 月的第 1 天到第 31 天8 月为大月共 31 天。每个属性的声明形态完全一致例如文档中的The10th声明为public static System.DateTime The10th { get; }全部 31 个属性及含义如下属性值均为System.DateTime年份取自当前年属性含义属性含义The1st当年 8 月 1 日The17th当年 8 月 17 日The2nd当年 8 月 2 日The18th当年 8 月 18 日The3rd当年 8 月 3 日The19th当年 8 月 19 日The4th当年 8 月 4 日The20th当年 8 月 20 日The5th当年 8 月 5 日The21st当年 8 月 21 日The6th当年 8 月 6 日The22nd当年 8 月 22 日The7th当年 8 月 7 日The23rd当年 8 月 23 日The8th当年 8 月 8 日The24th当年 8 月 24 日The9th当年 8 月 9 日The25th当年 8 月 25 日The10th当年 8 月 10 日The26th当年 8 月 26 日The11th当年 8 月 11 日The27th当年 8 月 27 日The12th当年 8 月 12 日The28th当年 8 月 28 日The13th当年 8 月 13 日The29th当年 8 月 29 日The14th当年 8 月 14 日The30th当年 8 月 30 日The15th当年 8 月 15 日The31st当年 8 月 31 日The16th当年 8 月 16 日属性命名遵循英文序数词规则1 为st、2 为nd、3 为rd其余为th11、12、13 也遵循th8 月不涉及这些特例。每个属性的值都精确指向当前年份的 8 月对应日期这一点非常关键它永远返回的是DateTime.Now.Year这一年的 8 月某天而不是固定年份。源码实现印证On.Days.cs 中August类开头的实现为public class August { /// summary /// The nth day of August of the current year /// /summary public static DateTime The(int dayNumber) new(DateTime.Now.Year, 8, dayNumber); /// summary /// The 1st day of August of the current year /// /summary public static DateTime The1st new(DateTime.Now.Year, 8, 1); // ... The2nd ~ The31st 以此类推 }可见每个属性本质上都是new DateTime(DateTime.Now.Year, 8, dayNumber)的语法糖封装属性的 Ordinalize 后缀只是为了让调用点读起来更像人话。测试用例 OnTests.cs 验证了这一行为模式以其他月份为例[Fact] public void OnJanuaryThe23rd() Assert.Equal(new(DateTime.Now.Year, 1, 23), On.January.The23rd); [Fact] public void OnFebruaryThe() Assert.Equal(new(DateTime.Now.Year, 2, 11), On.February.The(11));测试确认了属性/方法返回值 当年 指定月份 指定日这一等式。三、动态方法The(int dayNumber)除 31 个固定属性外On.August还提供一个参数化方法用于获取 8 月任意一天public static System.DateTime The(int dayNumber);参数dayNumberSystem.Int32类型表示 8 月内的天数1 到 31。返回值System.DateTime即当年 8 月dayNumber日的零点时刻。使用示例DateTime d1 On.August.The(1); // 当年 8 月 1 日 DateTime d2 On.August.The(15); // 当年 8 月 15 日 DateTime d3 On.August.The(31); // 当年 8 月 31 日The(int)与The1st~The31st固定属性的关系是固定属性是The(int)对 1~31 各参数值的预生成特化。二者底层实现完全一致都走new(DateTime.Now.Year, 8, dayNumber)这条路径差别只在于调用点的可读性——On.August.The23rd比On.August.The(23)更接近自然语言。当日期在循环、配置驱动等动态场景中才能确定时应使用The(int)当日期是写死的常量时优先使用固定属性以获得最佳可读性。需要提醒的是如果传入超出 1~31 范围的值如The(0)或The(32)DateTime构造函数会抛出ArgumentOutOfRangeException因为 8 月没有对应的日期。使用动态方法时应对输入做合法性校验。四、实现原理T4 模板自动生成On.August及另外 11 个月份类并非手写代码而是由 T4 文本模板Text Template Transformation Toolkit批量生成的。生成模板位于 On.Days.tt其核心逻辑为const int leapYear 2012; for (var month 1; month 12; month) { var firstDayOfMonth new DateTime(leapYear, month, 1); var monthName firstDayOfMonth.ToString(MMMM); // 输出 public class monthName { ... } for (var day 1; day DateTime.DaysInMonth(leapYear, month); day) { var ordinalDay day.Ordinalize(); // 输出 public static DateTime TheordinalDay new(DateTime.Now.Year, month, day); } }这段模板揭示了三个重要事实年份基准采用 2012 闰年模板以 2012 年作为标尺来计算每个月的天数因为 2012 是闰年能覆盖 2 月 29 日这一极端情况。月份名通过new DateTime(2012, month, 1).ToString(MMMM)获得本地化英文名从而生成January~December12 个嵌套类。天数由DateTime.DaysInMonth决定每个类生成多少个TheNth属性取决于该月在 2012 年有多少天。8 月有 31 天因此August恰好生成 31 个属性而 2 月因闰年会生成 29 个属性。序数后缀由Ordinalize()产生属性名中的1st/2nd/3rd/th后缀正是 Humanizer 自身的 OrdinalizeExtensions 能力在生成期内的复用——库用它生成自己的 API属于自举dogfooding设计。这意味着On.August的完整形态31 属性 1 方法全部由模板在构建期展开最终产物是 On.Days.cs 中约 2345 行代码的一部分开发者无需手工维护每个日期访问器。五、On 与 OnDateDateTime 与 DateOnly 双版本除了返回System.DateTime的On系列Humanizer 还提供了面向System.DateOnly的OnDate系列OnDate.August、OnDate.August.The1st等其定义在 OnDate.Days.cspublic class August { public static DateOnly The(int dayNumber) new(DateTime.Now.Year, 8, dayNumber); public static DateOnly The1st new(DateTime.Now.Year, 8, 1); // ... The2nd ~ The31st }OnDate系列的特点与使用建议仅在 .NET 6 及以上目标框架可用。生成模板 OnDate.Days.tt 开头使用#if NET6_0_OR_GREATER指令包裹低于该版本的编译目标不会包含OnDate类型。返回值类型为DateOnly纯日期、无时间分量而On系列返回DateTime含零点时间分量。如果你的业务只需要某年某月某日这一概念如生日、纪念日、排期优先用OnDate以避免无意义的时间分量如果需要与DateTime.Now直接比较或参与时间运算则用On。两者的月份类结构、属性命名、生成方式完全对称OnDate.August同样拥有The1st~The31st与The(int)全部成员。六、实战使用示例6.1 获取指定日期using Humanizer; // 当年 8 月 23 日属性方式可读性最佳 DateTime meetingDay On.August.The23rd; // 当年 8 月 1 日与 8 月 31 日 DateTime monthStart On.August.The1st; DateTime monthEnd On.August.The31st; // 动态天数变量方式 int targetDay 15; DateTime dynamicDay On.August.The(targetDay); // .NET 6 使用 DateOnly 版本 DateOnly anniversary OnDate.August.The23rd;6.2 计算距离某个 8 月日期的剩余天数TimeSpan remaining On.August.The31st - DateTime.Today; Console.WriteLine($距当年 8 月 31 日还有 {remaining.Days} 天);6.3 与 Humanizer 其他 API 组合使用On.August返回的DateTime可以无缝接入 Humanizer 的其他扩展例如用 DateHumanizeExtensions 做相对时间描述Console.WriteLine(On.August.The1st.Humanize()); // 例如 3 days from now Console.WriteLine(On.August.The1st.Ordinalize()); // 例如 August 1st七、使用注意事项年份是动态的On.August.The23rd返回的是当前年份的 8 月 23 日其年份取自DateTime.Now.Year。跨年运行时如程序跨越 12 月 31 日持续运行两次调用的返回值年份可能不同这一点在缓存计算结果、日志落库等场景中要特别留意。返回时刻为当天零点On系列返回的DateTime时间分量为00:00:00即当天的开始时刻需要当天其他时刻时请在此基础上自行AddHours等操作。参数范围校验The(int dayNumber)仅接受 1~31 的合法天数越界会抛出ArgumentOutOfRangeException。OnDate的框架门槛OnDate系列仅在NET6_0_OR_GREATER目标下编译产出若项目目标框架低于 .NET 6请使用On系列。可读性与动态性取舍固定属性The23rd适合字面量日期The(int)适合动态计算出的日期二者返回值语义完全等价。八、相关资源导航API 参考文档Humanizer.On.August.md生成源码On.Days.csAugust类自第 1370 行起生成模板On.Days.ttDateOnly 版本生成源码OnDate.Days.csDateOnly 版本生成模板OnDate.Days.tt单元测试OnTests.cs 与 OnDateTests.cs其他月份类On.January~On.December同位于 On.Days.cs结构与On.August完全一致仅月份参数与天数不同。赞分享开发工具【免费下载链接】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 流式日期 API 详解On.August 类的用法、源码实现与测试验证Humanizer 流式日期 API 详解On.August 类的用法、源码实现与测试验证 Humanizer 为 .NET 开发者提供了名为 Fluent开发工具Humanizer 流式日期 API 详解In.Two 类在 C 中的用法与实现原理Humanizer 流式日期 API 详解In.Two 类在 C 中的用法与实现原理 导读 In.Two 是 Humanizer 流式日期FluentDat开发工具Humanizer 流式日期 API 详解InDate.Six 类的属性、方法与实现原理Humanizer 流式日期 API 详解InDate.Six 类的属性、方法与实现原理 本文以 Humanizer 2.13.14 版本文档 InDate.开发工具上一篇ComfyUI-WanVideoWrapper模块化AI视频生成框架的技术解析与实践指南下一篇快速上手抖音无水印下载:douyin-downloader 单条、批量与直播下载教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/21 14:20:04

C++ Qt6 雷达模拟器实战:从 TCP 通信到 PPI 雷达界面的完整项目

一、项目简介 最近在学习 C 和 Qt 的过程中,我尝试从零实现了一个简单的雷达模拟器(Radar Simulator)。 这个项目并不是一个真实的雷达系统,而是一个用于学习和实践的模拟项目。 项目主要使用: C17 Qt 6 CMake T…

2026/11/21 14:17:05

模2运算详解:从异或到CRC校验的底层原理与实操

做通信协议和底层软件这行,几乎天天要和模2运算打交道。奇偶校验、CRC校验、LFSR伪随机序列、汉明码纠错,这些看似各不相同的技术,剥开外壳后核心全是模2加法、模2减法、模2乘法、模2除法这一套四则运算。很多人一开始觉得简单,不…

2026/11/21 14:18:24

攻击者画像关键技术:从日志聚类到团伙处置的工程实践

简介:这是一份面向网络安全从业者、安全态势感知研究人员及高校相关专业学生的技术文献,聚焦攻击者画像这一主动防御关键环节,帮助读者理解如何从攻击行为中识别意图、预测威胁并辅助溯源。资源为单份PDF文档,压缩包约1008KB&…

2026/11/22 14:03:37

北海低压电工证考点全解析,郑州报考避坑指南来了

北海低压电工证考点全解析,郑州报考避坑指南来了 之前考的证在外省能不能转过来?这个问题其实很多人都问过,特别是在郑州、南阳、北海等不同地区的电工朋友,跨省考证、换证、转证成了大家最头疼的问题之一。今天我们就从 北海低压电工证考点…

2026/11/22 14:03:37

电工证移民流程全流程办理指南:值不值得考?

电工证移民流程全流程办理指南:值不值得考? 怕考不过白交培训费?这是很多打算考电工证的朋友心里最担心的问题。特别是像你这种准备走【电工证移民流程】的考生,既担心花冤枉钱,又怕流程太复杂,搞不懂怎么操作。今天我就来给你讲清楚,从报考到移民全流…

2026/11/22 14:03:37

电工作业国标值不值得考?怕考不过白交培训费的都看过来

电工作业国标值不值得考?怕考不过白交培训费的都看过来 怕考不过白交培训费?你不是一个人,尤其是像驻马店的建筑工人,每天在工地上风吹日晒,好不容易攒点钱报了个电工作业国标培训,结果一不小心挂了,钱打水漂,还得重新来一遍。这种焦虑我懂,也经常遇…

2026/11/22 14:03:37

煤矿电工证需要学哪些 官方回应实操考试心里没底怕挂科

煤矿电工证需要学哪些 官方回应实操考试心里没底怕挂科 实操考试心里没底怕挂科,这是很多准备考煤矿电工证的人心里最真实的声音。尤其在煤矿这种高风险行业,操作不规范就可能酿成大祸。但很多人不清楚,煤矿电工证到底需要学哪些内容?官方回应了哪些关键…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 0:09:40

高压电工证还能年审吗良心建议来了,学历不高也能考!

高压电工证还能年审吗良心建议来了,学历不高也能考! 你是不是也担心,自己学历不高,根本报不上高压电工证?其实不然,现在政策已经非常明确, 高压电工证还能年审 ,而且只要符合条件, 学历不是门槛 , 良心建议…

2026/11/22 0:09:40

吴江的电工证免费培训怎么报名?官方报名入口全解析

吴江的电工证免费培训怎么报名?官方报名入口全解析 你急需特种作业证才能上岗找工作,但不知道从哪里下手?别急,现在就给你讲明白【吴江的电工证免费培训】到底怎么操作,以及怎么通过 官方报名入口…

2026/11/22 0:09:40

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱

电工证复审肃州区的真实经历:别被中介坑了,自己搞定更靠谱 不知道去哪报名怕被中介坑?这几乎是每个需要办理或复审电工证的人的真实经历。尤其在肃州区,信息不透明、流程复杂、中介收费高又不靠谱,让很多电工从业者感到头疼。作为一个在应急管理和特种作…

2026/11/22 9:39:14

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

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

2026/11/22 5:39:03

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
免费获取方案
☎咨询二维码 ☎ ↑