ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Humanizer 小数秒时间跨度人性化策略:IFractionalTimeSpanHumanizeStrategy 接口深度解析与自定义实现指南

Humanizer 小数秒时间跨度人性化策略:IFractionalTimeSpanHumanizeStrategy 接口深度解析与自定义实现指南 开发工具【免费下载链接】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点击查看免费下载导读当TimeSpan的精度下沉到亚秒级别如0.5 seconds、1.234 seconds时Humanizer 内置的整数时间单位输出就无能为力了。本文聚焦于 IFractionalTimeSpanHumanizeStrategy 接口——Humanizer 为时间跨度人性化TimeSpan humanization扩展出的小数秒支持抽象层逐一拆解其方法签名、九个参数的语义边界、默认实现的路由逻辑并给出可落地的自定义策略示例。读完本文你将掌握如何配置、验证乃至替换 Humanizer 的小数秒时间格式化行为。接口在时间跨度人性化体系中的定位Humanizer 把把TimeSpan变成人话这件事抽象为可替换的策略Strategy对外入口是 TimeSpanHumanizeExtensions.cs 中一系列Humanize扩展方法它们统一委托给Configurator.TimeSpanHumanizeStrategy完成实际格式化。从 Configurator.cs 可以看到默认策略是DefaultTimeSpanHumanizeStrategypublic static ITimeSpanHumanizeStrategy TimeSpanHumanizeStrategy { get; set; } new DefaultTimeSpanHumanizeStrategy();普通Humanize系列以毫秒Millisecond为最小输出单位而IFractionalTimeSpanHumanizeStrategy的出现是为了让输出能以秒Second为最小单位并携带最多 7 位的小数部分。官方 API 文档对其的定位是Extends a time-span humanization strategy with fractional-second support.为时间跨度人性化策略扩展小数秒支持。接口定义与完整方法签名接口本体定义在 IFractionalTimeSpanHumanizeStrategy.cs全部代码即一个方法namespace Humanizer; public interface IFractionalTimeSpanHumanizeStrategy { string HumanizeWithFractionalSeconds( TimeSpan timeSpan, int precision, bool countEmptyUnits, CultureInfo? culture, TimeUnit maxUnit, string? collectionSeparator, int maxFractionalDigits, MidpointRounding roundingMode, bool toSymbols); }方法的语义是将TimeSpan转换为以秒为最小单位的人性化文本。TimeUnit枚举定义于 TimeUnit.cs取值依次为Millisecond、Second、Minute、Hour、Day、Week、Month、Year。九个参数逐一拆解参数类型语义timeSpanTimeSpan待人性化的时间跨度。precisionint返回的最大时间单位数量如precision 2最多输出两个单位。countEmptyUnitsbool空时间单位是否计入precision。为true时即使某单位为 0 也占用一个精度名额。cultureCultureInfo?使用的区域性传null时使用当前文化CultureInfo.CurrentCulture。maxUnitTimeUnit允许输出的最大时间单位如TimeUnit.Hour则不会出现天/周等更大单位。collectionSeparatorstring?组合多个时间部分时使用的分隔符传null时使用该文化的默认 collection formatter 规则。maxFractionalDigitsint小数秒的最大位数取值范围0 到 7对应 tick 精度1 tick 100 纳秒。roundingModeMidpointRounding中点舍入模式小数秒功能仅支持ToEven与AwayFromZero两种。toSymbolsbool时间单位是否渲染为本地化符号如s、min而非完整单词。返回值string即最终的人性化文本。扩展方法入口谁在调用这个接口虽然接口本身面向策略实现者但日常使用几乎总是通过扩展方法触发。在 TimeSpanHumanizeExtensions.cs 中提供了两组共四个入口// 单词形式秒作为最小单位 public static string HumanizeWithFractionalSeconds( this TimeSpan timeSpan, int precision, int maxFractionalDigits, MidpointRounding roundingMode, CultureInfo? culture, TimeUnit maxUnit, string? collectionSeparator , ) // 带 countEmptyUnits 的重载 public static string HumanizeWithFractionalSeconds( this TimeSpan timeSpan, int precision, bool countEmptyUnits, int maxFractionalDigits, MidpointRounding roundingMode, CultureInfo? culture, TimeUnit maxUnit, string? collectionSeparator , ) // 符号形式 public static string HumanizeToSymbolsWithFractionalSeconds( this TimeSpan timeSpan, ...) // 符号形式 countEmptyUnits 重载 public static string HumanizeToSymbolsWithFractionalSeconds( this TimeSpan timeSpan, ...)核心路由逻辑三层回退所有入口最终汇聚到私有的HumanizeWithFractionalSecondsCoreTimeSpanHumanizeExtensions.cs它决定了当前配置的策略如何处理小数秒若配置的策略恰好是DefaultTimeSpanHumanizeStrategy直接强转调用其HumanizeWithFractionalSeconds虚方法走内置的小数秒实现DefaultHumanizeWithFractionalSeconds。若配置的策略实现了IFractionalTimeSpanHumanizeStrategy调用接口方法即自定义策略全权接管。否则普通策略先把整个时间跨度按maxFractionalDigitsroundingMode舍入如果舍入后仍存在可见的小数秒抛出InvalidOperationException提示当前配置的ITimeSpanHumanizeStrategy不支持小数秒请实现IFractionalTimeSpanHumanizeStrategy以处理真正的小数结果如果没有小数秒则以minUnit TimeUnit.Second回退到普通Humanize路径。可见实现该接口是让任意自定义策略支持小数秒的官方契约也是唯一的完整接管点。默认实现DefaultTimeSpanHumanizeStrategy默认策略类定义于 DefaultTimeSpanHumanizeStrategy.cs它同时实现IGrammaticalCaseTimeSpanHumanizeStrategy支持格变化感知的时长并声明HumanizeWithFractionalSeconds为virtual允许子类覆写public virtual string HumanizeWithFractionalSeconds( TimeSpan timeSpan, int precision, bool countEmptyUnits, CultureInfo? culture, TimeUnit maxUnit, string? collectionSeparator, int maxFractionalDigits, MidpointRounding roundingMode, bool toSymbols) TimeSpanHumanizeExtensions.DefaultHumanizeWithFractionalSeconds( timeSpan, precision, countEmptyUnits, culture, maxUnit, collectionSeparator, maxFractionalDigits, roundingMode, toSymbols);其内部实现DefaultHumanizeWithFractionalSeconds见 TimeSpanHumanizeExtensions.cs分几步走参数校验maxFractionalDigits必须在 0–7roundingMode只能是ToEven/AwayFromZeromaxUnit必须在Second到Year之间注意不能低于Second因为秒就是该功能的最小单位。整体舍入RoundToFractionalSecondPrecision基于decimal运算按10^(7 - maxFractionalDigits)tick 的量子粒度做整个量级的舍入而非逐单位舍入并从TimeSpan两端极值测试可以看出其刻意规避了符号位与溢出的边界问题。分解部件CreateFractionalSecondParts按Week → Second顺序切分precision控制部件数量上限countEmptyUnits决定 0 值单位是否占用精度名额。格式化部件非秒单位走常规FormatTimePart秒单位若是整数且落在int范围则走普通秒格式化否则调用DefaultFormatter.TimeSpanHumanizeWithFractionalSeconds渲染小数。若当前文化的 formatter 不是内置的DefaultFormatter又不实现IFractionalTimeSpanFormatter则抛出异常要求实现该接口。拼接最后用collectionSeparator或文化默认分隔规则把各部分连成最终字符串。自定义策略一个可复制的实现骨架基于接口契约接入自定义策略只需两步。第一步实现策略类型public class MyFractionalStrategy : IFractionalTimeSpanHumanizeStrategy { public string HumanizeWithFractionalSeconds( TimeSpan timeSpan, int precision, bool countEmptyUnits, CultureInfo? culture, TimeUnit maxUnit, string? collectionSeparator, int maxFractionalDigits, MidpointRounding roundingMode, bool toSymbols) { // 自行实现校验参数、舍入、分解、格式化、拼接 return 自定义结果; } }第二步通过Configurator替换全局策略Configurator.cs 的属性即可赋值Configurator.TimeSpanHumanizeStrategy new MyFractionalStrategy();之后所有HumanizeWithFractionalSeconds/HumanizeToSymbolsWithFractionalSeconds调用都会命中你的实现。若自定义策略只希望覆盖部分行为也可以继承DefaultTimeSpanHumanizeStrategy并仅覆写HumanizeWithFractionalSeconds虚方法以复用内置的舍入与分解逻辑。行为验证从测试用例看接口语义边界仓库中的 FractionalTimeSpanHumanizeTests.cs 是对该能力最直接的规格说明也是理解九个参数组合效果的绝佳样例输入参数输出说明TimeSpan.FromSeconds(0.5)precision1, digits70.5 seconds基础小数秒输出TimeSpan.FromTicks(1)digits70.0000001 seconds单个 tick 完整保留7 位精度上限TimeSpan.FromTicks(12345000)digits3, ToEven1.234 seconds中点舍入向偶数TimeSpan.FromTicks(12345000)digits3, AwayFromZero1.235 seconds中点舍入远离零TimeSpan.FromTicks(599996000)digits31 minute先整体舍入再分解进位到分钟1 小时 0.5 秒precision2, countEmptyUnitsfalse1 hour, 0.5 seconds小数秒可作为独立终止单位同上precision2, countEmptyUnitstrue1 hour空单位占用精度名额TimeSpan.FromSeconds(1.5)fr-FR1,5s符号形式沿用文化的小数点与秒符号TimeSpan.MaxValuedigits7922337203685.4775807 seconds极值无溢出异常边界同样有据可查maxFractionalDigits传-1或8抛出ArgumentOutOfRangeExceptionroundingMode传入方向性模式(MidpointRounding)2/3/4同样被拒绝见 TimeSpanHumanizeExtensions.cs 的ValidateFractionalSecondArgumentsTimeSpan.FromTicks(1)在digits0时输出0 seconds且在fr-FR下输出0 seconde说明舍入后归零仍走本地化名词单复数规则。此外 FractionalTimeSpanLocaleSweepTests.cs 还对各语言区域做了批量扫描确保本地化一致性。与相邻 API 的关系该接口与以下仓库文档形成完整的能力闭环TimeSpanHumanizeExtensions.md所有Humanize/HumanizeWithFractionalSeconds扩展方法的入口文档TimeSpanDehumanizeExtensions.md把人性化文本反向解析回TimeSpan可与本接口的输出形成写—读回路TimeUnit.mdmaxUnit参数的取值来源DefaultTimeSpanHumanizeStrategy.md内置默认实现的完整 API 参考DefaultFormatter.md负责最终单词/符号渲染的格式化器小数秒输出最终由其TimeSpanHumanizeWithFractionalSeconds落地。小结IFractionalTimeSpanHumanizeStrategy是 Humanizer 把时间跨度人性化能力延伸到亚秒精度的关键抽象它定义了HumanizeWithFractionalSeconds这一完整契约九个参数分别控制单位数量、空单位计权、文化、单位上限、分隔符、小数位与舍入、符号输出由DefaultTimeSpanHumanizeStrategy提供开箱即用的实现并通过Configurator.TimeSpanHumanizeStrategy支持整体替换或继承覆写。无论是想要控制秒以下精度的日志与监控文案还是需要完全自定义的时间显示策略这个接口都是接入点。赞分享开发工具【免费下载链接】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点击查看免费下载相关推荐vnet.pytorch训练全攻略参数调优、损失函数选择与模型评估实战vnet.pytorch训练全攻略参数调优、损失函数选择与模型评估实战 vnet.pytorch是一个基于PyTorch实现的V Net模型专门用于 vol开发工具Humanizer 中 IDateTimeOffsetHumanizeStrategy 接口详解自定义 DateTimeOffset.Humanize 日期人性化策略Humanizer 中 IDateTimeOffsetHumanizeStrategy 接口详解自定义 DateTimeOffset.Humanize 日期人开发工具深入解析 Humanizer.IDateTimeHumanizeStrategyDateTime.Humanize 时间距离人性化策略接口深入解析 Humanizer.IDateTimeHumanizeStrategyDateTime.Humanize 时间距离人性化策略接口 导读 IDateT开发工具上一篇GelEdgeDBGraphQL Mutations 实战指南Delete / Insert / Update 全解析下一篇Winpilot终极指南与Chris Titus工具集成轻松管理Windows系统 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表