Skip to main content

Humanize

Morrow can describe date-time distances in 81 languages and apply those distances back to a base value.

Humanize​

from std.collections import List

var present = Morrow(2026, 1, 1, 12, 0, 0, 0, TimeZone.from_utc("UTC"))

print(present.shift(hours=2).humanize(present))

var granularity = List[String]()
granularity.append("hour")
granularity.append("minute")

print(present.shift(minutes=66).humanize(present, granularity=granularity))

Use only_distance=True to omit the direction phrase.

Dehumanize​

var present = Morrow(2026, 1, 1, 12, 0, 0, 0, TimeZone.from_utc("UTC"))

print(present.dehumanize("2 days ago"))
print(present.dehumanize("in a minute and 6 seconds"))

Supported units include years, quarters, months, weeks, days, hours, minutes, and seconds.

Locale​

print(present.shift(hours=-2).humanize(present, locale="zh-CN"))
print(present.shift(hours=2).humanize(present, locale="zh-TW"))
print(present.dehumanize("1小时6分钟后", locale="zh-CN"))
print(present.shift(days=-3).humanize(present, locale="es"))  # hace 3 días
print(present.dehumanize("hace 3 días", locale="es"))

locale takes any of the 81 built-in locales or a Locale value; unknown names raise. dehumanize reads the text that humanize produces in the same locale, including multi-unit output; it does not parse arbitrary natural language. Chinese input uses numeric counts and explicit units, ending in 前 or 后/後. Multi-unit output and only_distance also support locales.