humanize

Human readable formatting and input parsing for Go.

Supported languages

• English (en)
• Polish (pl)
• Simplified Chinese (zh-CN)

Supported operations

Init with:

humanizer, err := humanize.New("en")

Time

Decoding duration from human input:

duration, _ := humanizer.ParseDuration("2 days, 5 hours and 40 seconds")
fmt.Println(duration) 
// Prints: 53h0m40s

Humanized time difference:

firstDate := time.Date(2017, 3, 21, 12, 30, 15, 0, time.UTC)
secondDate := time.Date(2017, 6, 21, 0, 0, 0, 0, time.UTC)

// Approximate mode.
fmt.Println(humanizer.TimeDiff(firstDate, secondDate, 0))
// Prints: in 3 months

// Precise mode.
fmt.Println(humanizer.TimeDiff(secondDate, firstDate, -1))
// Prints: 3 months, 1 day, 11 hours, 29 minutes and 45 seconds ago

Metric prefixes

Decoding value from human input:

value, _ := humanizer.ParsePrefix("1.5k")
fmt.Println(value)
// Prints: 1500

Number conversion:

// Quick usage.
fmt.Println(humanizer.PrefixFast(174512))
// Prints: 174.5k

// Controlled usage.
fmt.Println(humanizer.Prefix(1440000, 2, 1000, false))
// Prints: 1.44 mega