Skip to main content
Version: 3.0.1

What Humanizer does

Orientation​

Humanizer is a .NET library for turning program-shaped values into text people can read. Its extension methods cover identifiers, enums, dates and times, durations, numbers, byte sizes, quantities, and collections. Localization is part of those operations rather than a separate formatting pass.

Use Humanizer at display boundaries: view models, messages, reports, logs intended for people, and other presentation code. Keep stored values and protocol payloads in their typed forms.

Example​

The same small console program is compiled and run against the selected Humanizer 3.0.1 package during documentation validation:

Program.cs
using System.Globalization;
using Humanizer;

CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("en-US");
CultureInfo.CurrentUICulture = CultureInfo.GetCultureInfo("en-US");

var result = TimeSpan.FromMinutes(2).Humanize();
if (result != "2 minutes")
    throw new InvalidOperationException($"Unexpected result: {result}");

Console.WriteLine(result);

It prints 2 minutes. The culture is explicit, so the result does not change with the machine running the example.

Choose a path​

Documentation and support​

This is the frozen documentation snapshot for Humanizer 3.0.1. Documentation availability is not a promise that this release remains under active maintenance. Use the issue tracker for confirmed bugs and support questions.

Pitfall​

Humanized text is presentation output, not a stable serialization format. Do not persist it and later depend on parsing it back: cultures, wording, and formatting options can differ.

Version notes​

Package layout and target frameworks differ by release. Keep the version selector aligned with the Humanizer 3.0.1 package when following commands or API links on this page.