gotz
CLI timezone info tool for cross-timezone teams
TLDR
Show current time in multiple zones
$ gotz
Show time for specific city$ gotz [city-name]
Convert time between zones$ gotz "[time]" [from-zone] [to-zone]
List all supported timezones$ gotz --list
SYNOPSIS
gotz [options] [timezone-or-query]
DESCRIPTION
gotz is a command-line tool for working with timezones. It shows current times in different locations and converts times between timezones, making it useful for teams working across multiple regions.The tool can display multiple timezones simultaneously and supports fuzzy matching for city names.
PARAMETERS
-l, --list
List all supported timezones-c, --config FILE
Configuration file path-f, --format FORMAT
Time format string-v, --version
Display version and exit-h, --help
Display help and exit
EXAMPLES
Show configured timezones:
$ gotz
Show time in Tokyo:$ gotz tokyo
Convert 3pm NYC to Tokyo:$ gotz "3pm" America/New_York Asia/Tokyo
CONFIGURATION
Config file (~/.config/gotz/config.toml):
$ [zones]
default = ["America/New_York", "Europe/London", "Asia/Tokyo"]
default = ["America/New_York", "Europe/London", "Asia/Tokyo"]
INSTALL
brew install gotz
CAVEATS
Timezone names must follow IANA database. Fuzzy matching may return unexpected results. DST transitions may cause confusion.
HISTORY
gotz was created to simplify timezone conversions for distributed teams, providing a quick CLI alternative to online tools.
SEE ALSO
date(1), tzselect(1), timedatectl(1)
