Humanizer：一个功能强大开源 .NET 库，提供对字符串、枚举、日期、时间、时间跨度、数字和数量等扩展方法

推荐一个开源.Net库，方便我们操作和格式化：

字符串、枚举、日期、时间、时间跨度、数字等。

01 项目简介

Humanizer 是一个功能强大且广受欢迎的开源 .NET 库，其核心目标是

将机器友好的数据转换成人类更易读、更自然、更符合语言习惯的格式。

它为 .NET 中常见的数据类型（如字符串、枚举、数字、日期时间、时间间隔等）提供了大量扩展方法，让你的代码输出更加“人性化”，从而提升用户体验和代码的可读性。

简单来说，它让你的应用程序输出的文字看起来更像是自然语言，而不是冰冷的代码格式。

02 支持框架

1、支持.net48、.net6.0、.net7.0 和 ,net8.0；

2、指定语言：英语包

Humanizer.Core，您想要的特定语言包。例如，对于法语，请使用http://Humanizer.Core.fr。您可以安装任意数量的语言包来包含多种语言。

03 使用示例

1、字符串人性化 (String Humanization)

将机器的字符串（如 PascalCase, snake_case）转换为人类可读的句子。

// 将 PascalCase 或 snake_case 转换为带空格的句子
Console.WriteLine("PascalCaseInput".Humanize()); 
// 输出: "Pascal Case Input"

Console.WriteLine("snake_case_input".Humanize()); 
// 输出: "snake case input"

Console.WriteLine("HTML".Humanize()); 
// 输出: "HTML" (全大写被视为缩写，保持不变)

// 如果你想强制转换全大写单词，可以先转换大小写
Console.WriteLine("HTML".Transform(To.TitleCase)); 
// 输出: "Html" (注意：通常我们期望 "HTML" 保持原样)

// 使用 Transform 方法进行大小写转换 (推荐，旧的 LetterCasing 已过时)
Console.WriteLine("can return title case".Transform(To.TitleCase)); 
// 输出: "Can Return Title Case"

Console.WriteLine("CAN RETURN UPPER CASE".Transform(To.SentenceCase)); 
// 输出: "Can return upper case"

2. 字符串截断 (String Truncation)

智能地截断长字符串。

string longText = "This is a very long sentence that needs to be shortened.";

// 截断到指定长度，默认使用 '…' (Unicode 省略号)
Console.WriteLine(longText.Truncate(20)); 
// 输出: "This is a very long…"

// 使用自定义截断字符串
Console.WriteLine(longText.Truncate(20, "...")); 
// 输出: "This is a very long..."

// 从字符串开头截断
Console.WriteLine(longText.Truncate(20, Truncator.FixedLength, TruncateFrom.Left)); 
// 输出: "...needs to be shortened."

3. 数字人性化 (Number Humanization)

将数字转换为更易读或更自然的格式。

int number = 123456;
// 转换为英文单词
Console.WriteLine(number.ToWords()); 
// 输出: "one hundred and twenty-three thousand four hundred and fifty-six"

// 转换为序数词
Console.WriteLine(1.Ordinalize()); // 输出: "1st"
Console.WriteLine(2.Ordinalize()); // 输出: "2nd"
Console.WriteLine(21.Ordinalize()); // 输出: "21st"
Console.WriteLine(11.Ordinalize()); // 输出: "11th" (特殊规则)

// 将大数字转换为带单位的简洁形式 (K, M, G)
Console.WriteLine(number.ToMetric()); 
// 输出: "123.46K"

// 格式化文件大小
Console.WriteLine(1024.ToBits()); // 输出: "1.00 Kb"
Console.WriteLine(1048576.ToBits()); // 输出: "1.00 Mb"

4. 日期时间人性化 (DateTime Humanization)

将日期时间转换为相对时间描述，非常适用于显示“刚刚”、“2小时前”、“明天”等。

// 假设现在是 2025-08-20 22:00:00
DateTime now = DateTime.Now; // 2025-08-20 22:00:00

// 15分钟前
DateTime past = now.AddMinutes(-15);
Console.WriteLine(past.Humanize()); 
// 输出: "15 minutes ago" (根据实际时间差)

// 3小时前
DateTime threeHoursAgo = now.AddHours(-3);
Console.WriteLine(threeHoursAgo.Humanize()); 
// 输出: "3 hours ago"

// 明天
DateTime tomorrow = now.AddDays(1);
Console.WriteLine(tomorrow.Humanize()); 
// 输出: "tomorrow"

// 10天后
DateTime tenDaysLater = now.AddDays(10);
Console.WriteLine(tenDaysLater.Humanize()); 
// 输出: "in 10 days"

// 也可以用于未来的日期
DateTime future = now.AddHours(2);
Console.WriteLine(future.Humanize()); 
// 输出: "2 hours from now"

5. 时间间隔人性化 (TimeSpan Humanization)

将TimeSpan 对象转换为可读的描述。

TimeSpan duration = TimeSpan.FromHours(2) + TimeSpan.FromMinutes(30) + TimeSpan.FromSeconds(45);
// 默认只显示最大单位
Console.WriteLine(duration.Humanize()); 
// 输出: "2 hours"

// 指定精度 (显示前几个单位)
Console.WriteLine(duration.Humanize(precision: 2)); 
// 输出: "2 hours, 30 minutes"

Console.WriteLine(duration.Humanize(precision: 3)); 
// 输出: "2 hours, 30 minutes, 45 seconds"

// 使用 'and' 连接 (依赖于文化设置或自定义分隔符)
Console.WriteLine(duration.Humanize(precision: 3, collectionSeparator: ", and ")); 
// 输出: "2 hours, 30 minutes, and 45 seconds"

6. 枚举人性化 (Enum Humanization)

将枚举值转换为更友好的字符串。

public enum MovieGenre
{
    Action,
    ScienceFiction,
    [Description("Romantic Comedy")] // 使用 DescriptionAttribute 自定义
    RomCom
}

// 人性化枚举值
Console.WriteLine(MovieGenre.Action.Humanize()); 
// 输出: "Action"

Console.WriteLine(MovieGenre.ScienceFiction.Humanize()); 
// 输出: "Science Fiction" (自动添加空格)

Console.WriteLine(MovieGenre.RomCom.Humanize()); 
// 输出: "Romantic Comedy" (使用 Description 属性)

// 将人性化字符串转换回枚举 (Dehumanize)
string input = "Science Fiction";
var genre = input.DehumanizeTo<MovieGenre>();
Console.WriteLine(genre); 
// 输出: ScienceFiction

7. 单复数转换 (Pluralization/Singularization)

处理英语名词的单复数。

// 转复数
Console.WriteLine("apple".Pluralize()); 
// 输出: "apples"

Console.WriteLine("person".Pluralize()); 
// 输出: "people" (不规则复数)

Console.WriteLine("sheep".Pluralize()); 
// 输出: "sheep" (单复数同形)

// 转单数
Console.WriteLine("apples".Singularize()); 
// 输出: "apple"

Console.WriteLine("people".Singularize()); 
// 输出: "person"

04 项目地址

https://github.com/Humanizr/Humanizer

- End -

推荐阅读

C#实现Stdio通信方式的MCP Server

C#实现SSE通信方式的MCP Server

C#实现MCP Client 与 LLM 连接，抓取网页内容功能！

VS Code + Cline + 魔搭MCP Server 实现抓取网页内容。

C#实现自己的MCP Client