i18n-timezones

Localized timezone names for Elixir -- 36 locales, 152 timezones, zero runtime complexity.

Building a timezone picker? Displaying meeting times across regions? Your users expect to see "Eastern Time (US & Canada)" -- in their own language, not as a raw IANA identifier.

i18n_timezones provides human-friendly, localized timezone display names sourced from CLDR, the same data that powers ICU, Chrome, and Android. All translation data comes from the i18n_timezones_data package -- no external files to manage.

Why i18n_timezones?

36 locales covering 4+ billion speakers -- from Arabic to Vietnamese
CLDR-sourced -- accurate, professionally reviewed translations
ETS-backed -- concurrent reads with zero bottleneck, powered by OTP
Register what you need -- load individual locales or all at once
No panic -- all lookups return nil for missing data, mutations return {:error, reason}
Minimal dependencies -- only jason for JSON parsing

Install

def deps do
  [
    {:i18n_timezones, "~> 0.1"}
  ]
end

Quick Start

I18nTimezones.register_locale("de")
I18nTimezones.set_default_locale("de")

I18nTimezones.get_translation("Tokyo")
#=> "Tokio"

Usage

Register only what you need

I18nTimezones.register_locale("de")
I18nTimezones.register_locale("fr")

I18nTimezones.get_translation_for_locale("de", "Tokyo")
#=> "Tokio"

I18nTimezones.get_translation_for_locale("fr", "Tokyo")
#=> "Tokyo"

Register all locales at once

I18nTimezones.register_all_locales()
# All 36 locales now available

Using a default locale

I18nTimezones.register_locale("de")
I18nTimezones.set_default_locale("de")

I18nTimezones.get_translation("Tokyo")   #=> "Tokio"
I18nTimezones.get_translation("Berlin")  #=> "Berlin"

List available and registered locales

I18nTimezones.available_locales()    # all 36 locales in the data package
I18nTimezones.registered_locales()   # only the ones you&#39;ve loaded

API Reference

Function	Description
`register_locale(locale)`	Load translations for a single locale. No-op if already registered.
`register_all_locales()`	Load all 36 available locales.
`set_default_locale(locale)`	Set the default locale. Returns `{:error, reason}` if not registered.
`get_default_locale()`	Get the current default locale, or `nil`.
`get_translation(key)`	Get the localized name using the default locale.
`get_translation_for_locale(locale, key)`	Get the localized name for a specific locale.
`get_all_translations(locale)`	Get all translations for a locale as `{:ok, map}`.
`available_locales()`	List all locales in the data package.
`registered_locales()`	List all currently loaded locales.

All lookups return nil when a timezone or locale is not found -- no exceptions.

Supported Locales

36 locales covering major world languages:


ar	bn	ca	cs	da	de	el
en	es	eu	fi	fr	he	hi
hr	hu	id	it	ja	ko	ms
nl	no	pl	pt	pt-BR	ro	ru
sq	sv	th	tr	uk	vi	zh-CN
zh-TW

Data Source

All translations come from the Unicode CLDR (Common Locale Data Repository) -- the industry-standard source used by every major platform including iOS, Android, Chrome, and Java.

Also Available For

Ruby -- Rails gem with automatic time_zone_select integration
JavaScript/TypeScript -- NPM package with tree-shaking and dropdown helpers
Go -- Go module with embedded data via go:embed
Rust -- Crate with compile-time embedded data

License

MIT