dustin/go-humanize
Go Humanize
go-humanize is a Go library for converting raw numbers, byte sizes, and durations into natural language strings to improve human readability.
The project provides specialized formatters for byte sizes using SI or IEC standards and a relative time formatter that transforms durations into descriptions such as three days ago. It also includes an SI unit formatter for converting numeric values to and from International System of Units prefixes and symbols.
Beyond technical units, the library includes English natural language utilities for pluralizing nouns, generating ordinal numbers, and joining word lists with grammatical conjunctions. Additional numeric tools handle thousands separators, decimal precision, and large number suffixes.
Features
- Human-Readable Formatting Libraries - Provides a comprehensive suite of utilities for converting raw numbers, byte sizes, and durations into natural language strings.
- Data Size Formatting - Transforms raw byte counts into human-readable units such as KB, MB, or GB.
- Measurement Unit Parsers - Extracts numeric values and unit symbols from strings formatted with SI prefixes.
- Byte Size Formatting - Transforms byte counts into human-readable strings using SI or IEC standards and binary prefixes.
- Byte Size Parsers - Converts human-readable byte strings with size suffixes back into raw numeric byte values.
- SI Unit Conversions - Translates numeric values into human-readable strings using SI prefixes and unit symbols.
- Byte Size Formatting - Formats byte counts into human-readable strings using configurable precision and SI or IEC prefixes.
- Data Magnitude Formatting - Provides utilities to convert raw byte counts and large numbers into human-readable strings using SI or IEC standards.
- Human-Readable Numeric Formatting - Transforms large integers and floating point numbers into strings with thousands separators and natural language suffixes.
- Natural Language List Formatting - Implements programmatic formatting of word lists into grammatically correct human-readable sentences.
- Relative Time Formatting - Calculates and renders human-readable relative time descriptions based on duration magnitude thresholds.
- Magnitude Suffixes - Converts large integers into human-readable strings using suffixes like thousand, million, or billion.
- Pluralization Rules - Determines the correct English noun form based on numeric counts using regular and irregular grammar rules.
- Ordinal Formatters - Converts integers into rank-based ordinal strings by appending correct English suffixes.
- Word Form Converters - Converts English nouns to their plural forms based on numeric counts, including irregular plurals.
- Thousands Separators - Adds thousands-separator commas to integers and floating-point numbers for improved readability.
- English Linguistic Utilities - Provides tools for pluralizing nouns, formatting ordinal numbers, and joining word lists with grammatical conjunctions.
- Ordinal Number Formatting - Appends specific English rank suffixes to integers based on the numeric value of the last digits.
- Word Series Formatting - Constructs natural language lists by inserting commas and conjunctions between elements of a word series.
- Numeric Formatting - Provides general numeric formatting including customizable separators, decimal symbols, and precision.
- Text Processing - Converts data types into human-readable formats.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
