新闻详情

新闻详情

首页 / 资讯中心 / 详情

Humanizer OnDate.March 流畅日期 API 详解:用 DateOnly 构建三月的可读日期表达式

发布时间:2026/11/17 17:00:09来源:尧图网络
Humanizer OnDate.March 流畅日期 API 详解:用 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点击查看免费下载本篇技术指南深入解析 Humanizer FluentDate 体系中的OnDate.March类它是面向System.DateOnly的流畅日期访问器让你以OnDate.March.The14th或OnDate.March.The(14)这种接近自然语言的表达式直接获取当前年份 3 月 14 日这一日期值。读完本文你将掌握该类的全部 31 个静态属性与The(int)方法的签名、返回值语义、底层实现原理T4 模板代码生成、运行环境前提.NET 6以及它与On系列DateTime版本的对应关系并能在自己的 .NET 项目中直接落地使用。OnDate.March 类是什么OnDate.March是 Humanizer 中OnDate静态类的一个嵌套类文档原文将其定义为Provides fluent date accessors for March为三月提供流畅的日期访问器。其完整声明为public class OnDate.March继承关系为System.Object→OnDate.March同时该类还带有一个无参构造函数March()用于初始化类的实例由于成员均为静态实际使用时无需实例化。在 API 文档中OnDate.March暴露的成员可以分成三类31 个静态只读属性The1st到The31st分别对应 3 月的 1 日到 31 日1 个静态方法The(int dayNumber)按传入的日期数字返回对应的 3 月日期1 个构造函数March()。OnDate.March属于 Humanizer FluentDate 命名空间 中的OnDate体系。与On类返回System.DateTime不同OnDate系列专门为 .NET 6 引入的DateOnly类型设计因此整个类被#if NET6_0_OR_GREATER条件编译指令保护——只有目标框架为 .NET 6 或更高版本时这些成员才可用。全部 31 个日期属性The1st 到 The31stOnDate.March为 3 月的每一天都生成了一个静态属性属性名采用英文序数词风格命名The1st、The2nd、The3rd……The31st每个属性都返回一个System.DateOnly值语义为当前年份三月的第 N 天。完整清单如下属性说明属性说明The1st3 月 1 日The17th3 月 17 日The2nd3 月 2 日The18th3 月 18 日The3rd3 月 3 日The19th3 月 19 日The4th3 月 4 日The20th3 月 20 日The5th3 月 5 日The21st3 月 21 日The6th3 月 6 日The22nd3 月 22 日The7th3 月 7 日The23rd3 月 23 日The8th3 月 8 日The24th3 月 24 日The9th3 月 9 日The25th3 月 25 日The10th3 月 10 日The26th3 月 26 日The11th3 月 11 日The27th3 月 27 日The12th3 月 12 日The28th3 月 28 日The13th3 月 13 日The29th3 月 29 日The14th3 月 14 日The30th3 月 30 日The15th3 月 15 日The31st3 月 31 日The16th3 月 16 日每个属性的签名完全一致例如public static System.DateOnly The14th { get; }API 文档中标注的Property Value类型均为System.DateOnly。由于属性是静态且只读的访问时直接使用OnDate.March.The14th即可无需任何实例。The(int) 方法按数字取三月的任意一天除了固定命名的属性OnDate.March还提供一个通用的The(int dayNumber)方法用于按日期数字动态获取 3 月的某一天public static System.DateOnly The(int dayNumber);参数dayNumberSystem.Int32表示要获取的 3 月日期数字如 14 表示 3 月 14 日返回值System.DateOnly即当前年份 3 月dayNumber日对应的日期。实际使用示例using Humanizer; var piDay OnDate.March.The14th; // 3 月 14 日圆周率日 var sameDay OnDate.March.The(14); // 与上面等价动态传参 Console.WriteLine(piDay); // 输出形如2026-03-14 Console.WriteLine(piDay sameDay); // True当日期数字需要在运行时计算、无法预先静态写出时例如来自用户输入或循环遍历The(int)是比 31 个命名属性更灵活的选择。底层实现T4 模板批量生成的源代码OnDate.March并非手写代码而是由 T4 文本模板自动生成。模板位于 src/Humanizer/FluentDate/OnDate.Days.tt其生成逻辑如下以闰年2012为基准遍历 1 到 12 月通过new DateTime(leapYear, month, 1).ToString(MMMM)得到月份英文名从而生成January、February、March等 12 个嵌套类对每个月用DateTime.DaysInMonth(leapYear, month)确定该月天数3 月为 31 天因此March类恰好生成 31 个属性每个日期属性的名字由day.Ordinalize()生成——这正是 Humanizer 自己的序数词扩展方法1→1st、2→2nd、3→3rd、21→21st等从而得到The1st、The2nd、The3rd直到The31st的属性名每个属性与The(int)方法内部都统一使用new(DateTime.Now.Year, month, day)构造DateOnly。生成的实体代码位于 src/Humanizer/FluentDate/OnDate.Days.cs。以March类从第 391 行开始为例其成员实现如下public class March { /// summary /// The nth day of March of the current year /// /summary public static DateOnly The(int dayNumber) new(DateTime.Now.Year, 3, dayNumber); /// summary /// The 1st day of March of the current year /// /summary public static DateOnly The1st new(DateTime.Now.Year, 3, 1); // ... The2nd 到 The31st 依此类推 }从源码结构可以看出两个关键事实年份取自系统当前时间所有成员都使用DateTime.Now.Year作为年份因此返回的总是当前年份的 3 月日期。若在 2026 年运行OnDate.March.The1st即为2026-03-01跨年自动生效由于年份是运行时动态取的应用程序跨年后无需修改任何代码访问器会自动指向新一年的 3 月。测试验证生成结果如何被保障仓库通过两层测试保证 31 个属性与The(int)方法的正确性1. 直接断言测试tests/Humanizer.Tests/FluentDate/OnDateTests.cs该测试文件使用与生成代码相同的DateTime.Now.Year构造期望值验证访问器与手写构造的结果一致[Fact] public void OnJanuaryThe23rd() Assert.Equal(new(DateTime.Now.Year, 1, 23), OnDate.January.The23rd); [Fact] public void OnFebruaryThe() Assert.Equal(new(DateTime.Now.Year, 2, 11), OnDate.February.The(11));2. 反射式全覆盖测试tests/Humanizer.Tests/FluentDate/GeneratedFluentDateTests.cs该测试通过反射遍历OnDate下所有月份嵌套类OnDateDayPropertiesCoverAllGeneratedDayAccessors断言所有月份嵌套类的静态属性都能被解析为月 日并返回正确的DateOnlyOnDateTheMethodsCoverAllGeneratedMonthFactories断言每个月份类都存在The(int)方法且调用The(1)返回该月 1 日解析属性名时采用The前缀 序数后缀的规则TryParseDayProperty能识别1st/2nd/3rd/4th…全部 31 个属性名。这两类测试共同确保了模板生成的 31 个属性数量正确、命名符合序数词规则、返回日期与手写new DateOnly(year, 3, day)完全等价。环境前提与限制使用OnDate.March需要注意以下约束目标框架必须为 .NET 6 或更高因为返回值类型是System.DateOnly整个OnDate类连同InDate都被#if NET6_0_OR_GREATER条件编译包裹见 src/Humanizer/FluentDate/OnDate.Days.cs 第 1 行。在 .NET Framework 或 .NET 5 及以下项目中无法使用属性是静态的直接通过OnDate.March.The14th访问不需要实例化March类The(int)的入参是普通整数传入 1~31 之间的任意整数即可若需要特定命名可优先使用属性版本。与 On.MarchDateTime 版的对应关系Humanizer 的 FluentDate 提供了两套平行的日期 APIOn系列返回DateTimeOnDate系列返回DateOnly。场景文档 fluent-dates-and-time-spans.mdx 明确说明InDateandOnDateprovide correspondingDateOnlyvalues on compatible frameworks——即在支持DateOnly的框架上OnDate是On的对应版本。两者的成员结构完全平行On.March.The14th返回包含时间分量的DateTime时间为零点而OnDate.March.The14th返回不含时间的DateOnly。在选择时可以参考以下规则只需要日期语义、不关心时间部分、且目标是 .NET 6优先使用OnDate.March需要DateTime例如要与旧 API 互操作、参与时区转换使用On.March。此外InDate系列如InDate.March的月份访问器与In(5).Days之类的相对偏移提供了从当前日期偏移的DateOnly访问器与OnDate的绝对某月某日语义互补共同构成完整的 FluentDate 体验。相关 API 参考可见 Humanizer.OnDate.March、Humanizer.OnDate 与 Humanizer.InDate。实战组合示例将命名属性、动态方法与DateOnly的既有能力组合起来可以写出高度可读的业务代码using Humanizer; // 1) 静态命名圆周率日与白色情人节 DateOnly piDay OnDate.March.The14th; DateOnly whiteDay OnDate.March.The14th.AddDays(0); // 3 月 14 日 // 2) 动态传参根据配置项决定日期 int configuredDay 8; // 假设来自配置 DateOnly womenDay OnDate.March.The(configuredDay); // 3 月 8 日 // 3) 结合 DateOnly 计算本月剩余天数 DateOnly today DateOnly.FromDateTime(DateTime.Now); DateOnly endOfMarch OnDate.March.The31st; int daysLeftInMarch endOfMarch.DayNumber - today.DayNumber; Console.WriteLine($3 月还剩 {daysLeftInMarch} 天);以上代码同时体现了OnDate.March的两大价值代码自文档化OnDate.March.The14th比new DateOnly(2026, 3, 14)表达意图更直接与年份自适应无需关心具体年份始终指向当前年份的 3 月。小结OnDate.March是 Humanizer FluentDate 体系中OnDate静态类的 3 月访问器提供 31 个静态DateOnly属性The1st–The31st与一个The(int)动态方法全部返回当前年份三月的对应日期。它由 OnDate.Days.tt 模板借助 Humanizer 自身的Ordinalize()自动生成实体代码位于 src/Humanizer/FluentDate/OnDate.Days.cs并通过 OnDateTests.cs 与 GeneratedFluentDateTests.cs 双重验证。使用时需注意 .NET 6 的环境前提并可参照On.MarchDateTime版在两种返回类型之间按需选择。赞分享开发工具【免费下载链接】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 OnDate.March 流式日期访问器详解用自然语言式 API 构建 DateOnly 三月日期Humanizer OnDate.March 流式日期访问器详解用自然语言式 API 构建 DateOnly 三月日期 OnDate.March 是 Huma开发工具Humanizer OnDate.March 流式日期 API 指南用一行代码表达三月第几日的 DateOnly 访问器Humanizer OnDate.March 流式日期 API 指南用一行代码表达三月第几日的 DateOnly 访问器 本文以 Humanizer 的开发工具Humanizer OnDate.September 详解用流式 API 构建 9 月日期DateOnlyHumanizer OnDate.September 详解用流式 API 构建 9 月日期DateOnly 本篇指南聚焦 Humanizer 的 OnDa开发工具上一篇SmartTube终极指南如何在Android TV上完美开启HDR视频播放下一篇终极指南深入理解Trino分布式事务的两阶段提交实现创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉