timezone-convert is a small and efficient utility library and CLI for (smart parsing and) converting between timezone formats.
The primary goal of the project is to focus on converting from one timezone format into a roughly accurate representation in other formats for possible of use with other libraries (e.g Windows display name from calendar => TZID / IANA for datetime manipulation), and AS SIMPLE AS POSSIBLE, things like extensive array mapping (Windows id => Multiple IANA ids) won't be available.
The project will only supports the ETC IANA ids that is also used by Windows, and only supports the commonly-used backward IANA ids (like America/Indianapolis), uncommon ids like WET, W-SU is not supported, but in a fast-check, this library should support a few more commonly-used ids than windows-iana.
- Parsing and converting between:
- Windows display name
- Windows time zone id
- IANA (Olsen) tzdb ids
- Auto parse from any formats, just
parseTzAuto(str)
npx timezone-convert "Europe/Athens"
# Outputs a JSON string of the parsed timezone
# { iana, windowsId, windowsDisplay }
# Example use with `jq`
npx -y timezone-convert Asia/Saigon | jq '.windowsDisplay'# npm
npm install timezone-convert
# bun
bun add timezone-convert
# pnpm (recommended)
pnpm install timezone-convert// ESM
import { parseTzAuto } from 'timezone-convert'
const bucharestTz = parseTzAuto('Europe/Bucharest')