timezone-converter

Convert times and inspect meeting-hour overlap across timezones from the terminal.

Uses Intl timezone formatting, a built-in alias map and commands for world clocks, offsets, Unix timestamps and meeting windows.

Quickstart

Package runtime requirement: Node.js >=20. Git is needed to obtain this pinned source checkout.

git clone https://github.com/NickCirv/timezone-converter.git
cd timezone-converter
git checkout 501a62e7c8eaa9fab9a82f9d9084fe0349e226c3
node index.js unix 1700000000 --zone Asia/Dubai --json

This source-derived example has not been executed in this review. The command converts a fixed timestamp for the selected IANA zone; the output is derived from the installed runtime’s timezone data.

Usage

node index.js convert '14:30' --from Europe/London --to Asia/Dubai
node index.js world --zones 'Europe/London,Asia/Dubai'
node index.js meeting --zones 'Europe/London,Asia/Dubai' --work-start 9 --work-end 18

list searches supported zones; offset <zone> displays an offset. Prefer IANA names to ambiguous abbreviations.

Command reference covers arguments, modes and output controls.

Behavior and limits

Time-only inputs and meeting searches depend on the reference date. DST detection compares seasonal offsets heuristically; ambiguous/nonexistent local times are not a complete scheduling workflow. Verify boundary dates and conversions against a calendar before making time-sensitive commitments.

Development

Declared package scripts:

Script	Command
test	node --test

The smoke test syntax-checks the entrypoint; it does not exercise CLI behavior or integrations.

Research

Source review and claim ledger records revision 501a62e7c8ea, inspected files and verification gaps.

License and attribution

Protected license and attribution files remain unchanged: LICENSE.

Artwork credits · Nicholas Ashkar — consulting