Humanizer OnDate.September 详解：用 Fluent API 优雅构造九月的每一天

开发工具【免费下载链接】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点击查看免费下载OnDate.September是 Humanizer FluentDate 体系中的一个静态访问器类用于以自然语言风格直接获取当前年份九月中任意一天的System.DateOnly值例如OnDate.September.The1st表示今年的 9 月 1 日。通过本文你将掌握该类的全部 30 个静态属性与动态方法The(int dayNumber)的用法、其背后的 T4 模板生成原理以及基于源码与测试用例的最佳实践与边界约束。类定位FluentDate 中的 DateOnly 访问器OnDate.September定义于 Humanizer 的 FluentDate 目录 之下命名空间为Humanizer其 API 参考文档位于 Humanizer.OnDate.September.md。该类的完整声明为public class OnDate.September继承关系System.Object→September是一个普通静态成员类本身非静态类但所有成员均为静态。返回类型所有成员统一返回System.DateOnly即 .NET 6 引入的仅日期结构体不含时间分量。平台前提对应实现被#if NET6_0_OR_GREATER条件编译保护见 OnDate.Days.cs因此该类仅在 .NET 6 及更高目标框架下可用。从源码结构看OnDate是面向DateOnly的整套 12 个月份访问器容器同目录下还存在返回DateTime的On系列On.Days.cs以及面向相对时间的In/InDate系列共同构成 Humanizer 的 FluentDate 日期表达式 DSL。完整属性清单The1st 到 The30th与原 API 文档一致OnDate.September提供 30 个静态只读属性分别对应九月30 天月份的每一天。九月没有The31st这是与 31 天月份类如OnDate.January包含The31st见 Humanizer.OnDate.January.md的显著差异。每个属性的声明形式均为public static System.DateOnly The10th { get; }完整成员清单如下属性含义属性含义The1st今年 9 月 1 日The16th今年 9 月 16 日The2nd今年 9 月 2 日The17th今年 9 月 17 日The3rd今年 9 月 3 日The18th今年 9 月 18 日The4th今年 9 月 4 日The19th今年 9 月 19 日The5th今年 9 月 5 日The20th今年 9 月 20 日The6th今年 9 月 6 日The21st今年 9 月 21 日The7th今年 9 月 7 日The22nd今年 9 月 22 日The8th今年 9 月 8 日The23rd今年 9 月 23 日The9th今年 9 月 9 日The24th今年 9 月 24 日The10th今年 9 月 10 日The25th今年 9 月 25 日The11th今年 9 月 11 日The26th今年 9 月 26 日The12th今年 9 月 12 日The27th今年 9 月 27 日The13th今年 9 月 13 日The28th今年 9 月 28 日The14th今年 9 月 14 日The29th今年 9 月 29 日The15th今年 9 月 15 日The30th今年 9 月 30 日所有属性均为基于当前年份的计算属性无论何时访问返回的日期年份始终取DateTime.Now.Year月份固定为 9日期为属性名对应的序号。动态方法The(int dayNumber)除了 30 个固定属性OnDate.September还提供一个参数化入口用于以变量方式指定九月中的任意一天public static System.DateOnly The(int dayNumber);参数dayNumberSystem.Int32表示九月的第 N 天。返回值System.DateOnly即当前年份九月的第dayNumber天。典型用法是配合循环或动态业务值构造日期例如距开学第 N 天这类场景for (int day 1; day 30; day) { DateOnly date OnDate.September.The(day); Console.WriteLine(date); // 输出今年 9 月 1 日 … 今年 9 月 30 日 }从源码实现看The(int dayNumber)直接执行new(DateTime.Now.Year, 9, dayNumber)。由于System.DateOnly构造函数会校验日期合法性当dayNumber不在 1–30 的合法区间内时例如 0、31 或负数会抛出ArgumentOutOfRangeException这一点在实际调用时需要自行保证参数范围。实战示例在项目中直接使用以下代码可在 .NET 6 项目中直接运行需引用 Humanizer 程序集并using Humanizer;using Humanizer; // 固定属性开学纪念日今年 9 月 1 日 DateOnly schoolOpening OnDate.September.The1st; // 属性与 DateTime 互转 DateTime asDateTime OnDate.September.The10th.ToDateTime(TimeOnly.MinValue); // 动态方法报到日由变量决定 int checkInDay 15; DateOnly checkIn OnDate.September.The(checkInDay); // 与字符串化、序数化能力组合输出如 September 15 string label checkIn.ToString(MMMM d); Console.WriteLine($开学日{schoolOpening}); Console.WriteLine($报到日{label}{checkIn});结合 Humanizer 的其他扩展你可以进一步把该日期输出为自然语言例如使用 DateToOrdinalWordsExtensions 或 DateHumanizeExtensions 生成9 月 15 日或3 天前等人类可读文案使 FluentDate 的取值能力与 Humanizer 的格式化能力形成完整闭环。源码实现与 T4 生成机制OnDate.September的实现位于 OnDate.Days.cs其核心逻辑极其精简——每个成员都只是一行表达式public class September { public static DateOnly The(int dayNumber) new(DateTime.Now.Year, 9, dayNumber); public static DateOnly The1st new(DateTime.Now.Year, 9, 1); // ... The30th 同理 }值得注意的是这 30 个属性并非手写而是由 T4 文本模板 OnDate.Days.tt 自动生成的模板机制可以总结为以下几点闰年锚点模板以leapYear 2012为基准遍历 12 个月确保 2 月 29 日这类仅闰年存在的日期也能被覆盖到。月份名推导通过new DateTime(leapYear, month, 1).ToString(MMMM)获得本地化月份名如September并据此生成对应类名。天数推导用DateTime.DaysInMonth(leapYear, month)计算当月天数因此 9 月只会生成The1st–The30th不会有 31 号。序数词生成调用 Humanizer 的day.Ordinalize()把数字转成1st、2nd、3rd、21st、22nd、23rd、30th等属性名后缀这正是属性命名中 11/12/13 与 21/22/23 后缀差异的来源。条件编译模板整体输出被#if NET6_0_OR_GREATER包裹与DateOnly的可用性保持一致。理解了这套生成机制就可以从源码层面解释该 API 文档中的每一个成员它们不是手写常量而是由固定年份 月份 序号模板批量推导的、随DateTime.Now.Year动态变化的计算属性。测试验证与使用注意事项Humanizer 仓库在 OnDateTests.cs 中为该系列提供了验证用例例如[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));同样的模式适用于OnDate.September将月份换为 9。基于源码与测试使用时有以下几点值得注意年份动态性所有成员返回当前年份的九月日期跨年调用会产生不同的DateOnly若需要指定年份应改用new DateOnly(year, 9, day)自行构造。合法范围固定属性天然限定在 1–30The(int dayNumber)接受任意int但非 1–30 的值会触发DateOnly构造时的参数校验异常业务代码应先做边界判断。框架版本类仅在NET6_0_OR_GREATER下编译面向 .NET Framework 或 .NET 5 的项目无法使用该 API可退回On.September返回DateTime系列。静态调用所有成员均为静态无需实例化OnDate或September直接以OnDate.September.The15th形式调用即可。相关资源API 参考Humanizer.OnDate.September.md源码实现OnDate.Days.cs生成模板OnDate.Days.tt测试用例OnDateTests.cs同类 APIHumanizer.OnDate.January.md含 31 天对照赞分享开发工具【免费下载链接】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.September 流式日期 API 完全指南用 DateOnly 表达九月第 N 天Humanizer OnDate.September 流式日期 API 完全指南用 DateOnly 表达九月第 N 天 本文是 Humanizer 流式开发工具Humanizer OnDate.September 详解用流式 API 构建 9 月日期DateOnlyHumanizer OnDate.September 详解用流式 API 构建 9 月日期DateOnly 本篇指南聚焦 Humanizer 的 OnDa开发工具Humanizer OnDate.December 流畅日期 API 完全指南用 C 优雅构造当年 12 月的每一天Humanizer OnDate.December 流畅日期 API 完全指南用 C 优雅构造当年 12 月的每一天 导读 OnDate.December 是开发工具上一篇ViGEmBus虚拟手柄驱动终极指南5分钟让任何手柄变Xbox控制器下一篇天穹飞控GPS定点悬停调参指南从打杆匀加速到刹车匀减速的实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考