Python Humanize Module
The humanize library provides various common humanization utilities, like turning a number into a fuzzy human-readable duration ("3 minutes ago") or into a human-readable size or throughput.
Installation
pip install humanizeImporting the Module
import humanize
import datetimeIntegers
Comma Separation (intcomma)
Converts an integer to a string containing commas every three digits.
print(humanize.intcomma(12345)) # 12,345
print(humanize.intcomma(123456789)) # 123,456,789Word Representation (intword)
Converts a large integer to a friendly text representation. Works best for numbers over a million.
print(humanize.intword(12345591313)) # 12.3 billion
print(humanize.intword(1000000)) # 1.0 millionAP Style Numbers (apnumber)
For numbers 1-9, returns the number spelled out. Otherwise, returns the number. This follows Associated Press style.
print(humanize.apnumber(4)) # four
print(humanize.apnumber(41)) # 41Date and Time
Natural Time (naturaltime)
Returns a fuzzy time span relative to now.
import datetime
now = datetime.datetime.now()
ago = now - datetime.timedelta(hours=24)
print(humanize.naturaltime(ago)) # a day ago
future = now + datetime.timedelta(seconds=30)
print(humanize.naturaltime(future)) # 30 seconds from nowNatural Delta (naturaldelta)
Formats a timedelta object into a human-readable string.
delta = datetime.timedelta(seconds=1001)
print(humanize.naturaldelta(delta)) # 16 minutesFile Sizes (naturalsize)
Formats a number of bytes into a human-readable file size (e.g., '13 KB', '4.1 MB').
print(humanize.naturalsize(1024)) # 1.0 kB
print(humanize.naturalsize(1024, binary=True)) # 1.0 KiB
print(humanize.naturalsize(1000000)) # 1.0 MBScientific Notation (scientific)
print(humanize.scientific(0.0000000000003)) # 3.0 x 10⁻¹³
print(humanize.scientific(10000)) # 1.0 x 10⁴