Humanizer Documentation

Humanizer meets all your .NET needs for manipulating and displaying strings, enums, dates, times, timespans, numbers and quantities.

Getting Started

• Installation - How to install and configure Humanizer
• Quick Start Guide - Get up and running quickly

Core Features

String Manipulation

• String Humanization - Transform computerized strings to human-readable text
• String Dehumanization - Convert back to PascalCase
• String Transformations - Apply custom transformations with IStringTransformer
• String Truncation - Intelligent truncation strategies

Enumerations

• Enum Humanization - Make enums readable
• Enum Dehumanization - Parse strings back to enums

Date and Time

• DateTime Humanization - Relative time ("2 hours ago", "tomorrow")
• TimeSpan Humanization - Human-readable durations
• Fluent Date API - Readable date/time construction and manipulation
• DateTime to Ordinal Words - "1st of January 2020"
• TimeOnly to Clock Notation - "half past two" (.NET 6+)

Numbers

• Number to Words - "123" → "one hundred twenty-three"
• Number to Ordinal Words - "1" → "first"
• Words to Number - "forty-two" → 42
• Ordinalization - "1" → "1st"
• Roman Numerals - Convert to/from Roman numerals
• Metric Numerals - "1230" → "1.23k"
• Number to Numbers - Fluent API for large numbers
• Tupleize - "2" → "double"

Collections

• Collection Humanization - Turn lists into "item1, item2, and item3"
• ToQuantity - "5 cases", "1 man", "2 men"

Word Manipulation

• Pluralization - Handle singular/plural forms
• Singularization - Convert plurals to singular
• Inflector Methods - Pascalize, Camelize, Underscore, Kebaberize, etc.

Specialized Features

• ByteSize - Human-readable byte sizes
• Heading - Convert headings to text
• Time Unit Symbols - "ms", "s", "min", etc.

Advanced Topics

• Localization - Multi-language support, YAML locale data, and inheritance
• Custom Vocabularies - Add custom pluralization rules
• Extensibility - Implement custom transformers and truncators
• Configuration - Customize Humanizer behavior

Migration Guides

• Migrating from 2.14.1 to 3.0.8 - Comprehensive breaking changes, patch-line fixes, and known regressions
• Namespace migration details - Namespace-only migration guidance and analyzer usage

API Reference

• Complete API Reference - Full API documentation

Contributing

• Contributing Guide - How to contribute to Humanizer