开发工具【免费下载链接】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.NET 字符串、枚举、日期与数量处理库中In.Eight这一流式日期FluentDateAPI它用一组静态属性和方法以8 秒/分钟/小时/天/周/月/年后的自然语义计算相对日期。读完本文你将掌握In.Eight全部 7 个属性与 7 个方法的确切行为、UTC 基准、DateOnly变体以及它在 In.SomeTimeFrom.cs 中由 T4 模板代码生成并受测试套件验证的底层实现。概述In.Eight是什么In.Eight是 HumanizerIn静态类中一个嵌套的静态类属于 FluentDate 目录 提供的流式日期Fluent DateAPI 家族。它的设计意图是让调用代码读起来像英文句子var reminder In.Eight.Hours; // 从现在起 8 小时后 var deadline In.Eight.DaysFrom(today); // 从给定日期起 8 天后在 Humanizer v3.0.10 的 API 参考中In.Eight的完整签名为public static class In.Eight继承链为System.Object→Eight全部成员均为public static且不依赖任何配置即可直接使用。它和兄弟类In.One~In.TenIn.SomeTimeFrom.cs一起覆盖了 1 到 10 的常见相对日期场景。七个只读属性从现在起算的 8 个单位In.Eight提供 7 个属性每个都返回一个System.DateTime语义均为从现在起 8 个 X 之后。下表是 API 参考中的完整清单属性返回类型语义底层实现UTCSecondsDateTime8 秒后DateTime.UtcNow.AddSeconds(8)MinutesDateTime8 分钟后DateTime.UtcNow.AddMinutes(8)HoursDateTime8 小时后DateTime.UtcNow.AddHours(8)DaysDateTime8 天后DateTime.UtcNow.AddDays(8)WeeksDateTime8 周后DateTime.UtcNow.AddDays(56)MonthsDateTime8 个月后DateTime.UtcNow.AddMonths(8)YearsDateTime8 年后DateTime.UtcNow.AddYears(8)实现要点UTC 基准与周的单位换算查看 In.SomeTimeFrom.cs 中Eight类的源码可以发现两个关键细节属性基于DateTime.UtcNow计算返回的是 UTC 时刻的DateTime。如果需要本地时间展示应在其后调用.ToLocalTime()。周Week被换算为天DayWeeks DateTime.UtcNow.AddDays(56)而不是使用AddWeeks——因为System.DateTime本身没有AddWeeks方法Humanizer 以8 * 7 56天的方式实现这与In.Three.Weeks AddDays(21)、In.Ten.Weeks AddDays(70)等兄弟类的实现完全一致。七个 From 方法从指定日期起算In.Eight还提供 7 个静态方法接受一个System.DateTime date参数并返回System.DateTime语义为从传入日期起 8 个 X 之后方法签名语义底层实现SecondsFrom(DateTime date)从 date 起 8 秒后date.AddSeconds(8)MinutesFrom(DateTime date)从 date 起 8 分钟后date.AddMinutes(8)HoursFrom(DateTime date)从 date 起 8 小时后date.AddHours(8)DaysFrom(DateTime date)从 date 起 8 天后date.AddDays(8)WeeksFrom(DateTime date)从 date 起 8 周后date.AddDays(56)MonthsFrom(DateTime date)从 date 起 8 个月后date.AddMonths(8)YearsFrom(DateTime date)从 date 起 8 年后date.AddYears(8)与属性不同方法不做任何时区换算直接基于传入的date值做偏移In.SomeTimeFrom.cs。这意味着传入值的KindUtc/Local/Unspecified会被原样保留适合在既有时间线上追加偏移量var shipDate new DateTime(2026, 9, 20, 10, 0, 0, DateTimeKind.Utc); var dueDate In.Eight.DaysFrom(shipDate); // 2026-09-28 10:00:00 UTC var reviewDate In.Eight.MonthsFrom(shipDate); // 2027-05-20 10:00:00 UTC源码级原理解析T4 模板生成与 partial 类结构类名由 T4 模板批量生成In.One~In.Ten十个兄弟类并非手工编写而是由 T4 文本模板 In.SomeTimeFrom.tt 生成模板用一个for (var i 1; i 10; i)循环先通过i.ToWords().Dehumanize()把数字转成单词并去人化得到类名如8→Eight再对每个类生成 7 组属性/方法对。Eight正是该循环第 8 次迭代的产物因此它的命名、签名与One~Ten完全同构——看到In.Eight的 API就等于看到了整个In数字系列的 API 形态。In是一个 partial 类家族In类本身由多个 partial 文件拼合而成共同构成完整的流式日期能力In.cs提供In.TheYear(int year)返回指定年份的 1 月 1 日In.SomeTimeFrom.cs提供In.One~In.Ten各单位的相对日期属性与方法In.Months.cs提供In.January、In.February……In.December以及In.JanuaryOf(int year)等月份访问器同目录下的 On.Days.cs、On.Days.tt 等则负责某月某日的另一套流式 API。也就是说In.Eight.Hours只是 Humanizer FluentDate 体系的一个切片它与月份、年份访问器互补前者回答8 小时后是哪一刻后者回答明年的 3 月是哪一天。面向 .NET 6 的DateOnly变体InDate.Eight由于System.DateOnly.NET 6 引入不含秒、分、时概念Humanizer 在#if NET6_0_OR_GREATER条件下额外提供InDate类族。在 InDate.SomeTimeFrom.cs 中InDate.Eight提供Days、Weeks、Months、Years四个属性及对应的DaysFrom、WeeksFrom、MonthsFrom、YearsFrom方法返回类型为DateOnly且每个 From 方法都有DateOnly与DateTime两个重载后者内部通过DateOnly.FromDateTime(...)转换。适合只需日历日期、不关心时刻的业务场景例如8 个月后的账单日。测试验证相对日期语义有据可依In.Eight的行为由测试套件严格把关主要依据有两处GeneratedFluentDateTests.cs通过反射遍历In的所有嵌套类型One~Ten含Eight对每个静态属性先记录DateTime.UtcNow的前后快照再用Assert.InRange(actual, Add(before, amount, unit), Add(after, amount, unit))验证属性落在预期偏移区间内对每个*From方法则用固定的基准日期如2024-02-29 10:20:30 UTC断言Assert.Equal(Add(date, amount, unit), actual)。其中amount 8、unit由成员名解析Add的switch表达式与源码实现一一对应Week date.AddDays(amount * 7)。InTests.cs给出流式组合的集成示例——var baseDate On.January.The21st; var date In.Five.DaysFrom(baseDate); Assert.Equal(baseDate.AddDays(5), date);。把In.Five换成In.Eight即可验证 8 天偏移的等价行为。这两个测试共同确认In.Eight的属性是基于当前 UTC 时刻的动态值而 From 方法是基于入参的纯函数式偏移二者都精确遵循AddSeconds/AddMinutes/AddHours/AddDays/AddMonths/AddYears周天×7的语义。实战用法与注意事项典型场景一定时任务调度提示// 用属性表达相对当前时刻 var retryAt In.Eight.Minutes; // UTC 时刻 var reportDue In.Eight.Weeks; // 8 周后的 UTC 时刻 // 用方法表达相对业务时间点 var expiresAt In.Eight.MonthsFrom(subscription.StartDate);典型场景二与其它 Humanizer API 组合In.Eight返回的DateTime可以继续交给 Humanizer 的Humanize()扩展DateHumanizeExtensions.cs生成自然语言描述形成计算 展示的完整链路var future In.Eight.Hours; var text future.Humanize(); // 例如 8 hours from now注意事项属性是动态快照每次访问In.Eight.Seconds都会重新读取DateTime.UtcNow并计算多次访问可能得到略有差异的毫秒级结果需要稳定值时请先赋值给局部变量。时区属性产物为 UTC跨时区场景请配合.ToLocalTime()或基于本地DateTime的 From 方法。命名约定One类使用单数成员名Second、Minute……Eight等 2~10 类使用复数成员名Seconds、Minutes……这是 T4 模板中var plural i 1 ? s : ;决定的引用时注意拼写。DateOnly需求目标框架为 .NET 6 及以上且只需要日期时优先使用 InDate.Eight避免引入无关的时间分量。总结In.Eight是 Humanizer FluentDate API 中以 8 为量、以秒/分/时/天/周/月/年为单位的相对日期计算的完整入口7 个基于 UTC 的属性回答从现在起 8 个单位后7 个 From 方法回答从指定时刻起 8 个单位后另有 .NET 6 的InDate.Eight提供DateOnly变体。其实现由 T4 模板统一生成、以DateTime.Add*为基础、由反射测试精确校验属于可以直接放心嵌入业务代码的成熟 API。更多流式日期能力可继续阅读 On.Days.cs某月某日与 In.Months.cs月份与年份等兄弟模块。赞分享开发工具【免费下载链接】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 详解InDate.Two 相对日期计算与源码实现Humanizer 流式日期 API 详解InDate.Two 相对日期计算与源码实现 InDate.Two 是 Humanizer 流式日期FluentD开发工具Humanizer FluentDate 实战In.Eight 相对日期 API 完整指南Humanizer FluentDate 实战In.Eight 相对日期 API 完整指南 In.Eight 是 Humanizer FluentDate 子开发工具Humanizer In.Eight 详解用流式 API 表达8 个时间单位之后的日期Humanizer In.Eight 详解用流式 API 表达8 个时间单位之后的日期 导读 Humanizer.In.Eight 是 Humanizer开发工具上一篇群晖NAS百度网盘套件终极安装指南从零开始轻松搭建下一篇GI-Model-Importer-Assets安全指南确保资产文件使用的安全性与合规性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
