🌐 A time zone helper

tz helps you schedule things across time zones. It's an interactive TUI program that displays time across the time zones of your choosing.

Usage

Run tz with no arguments to show the local time, as well as the UTC time zone. It gets more useful when you pass some time zones to the program, to list those below the local time zone.

For now, you need to select the time zones from the tz_data list. Yes, there are plans to make this friendlier for humans too. You're welcome to file an issue about it. I enjoy reading those.

If you would rather not type the list everytime, you could set an alias for your shell, or use the TZ_LIST environment variable with a semi-colon separated list of tz data zone names (see Configuration below). Command-line arguments trump the environment variable.

Check out tz -h for other flags.

The program will adjust to light and dark terminals themes.

Installing

Go

go install github.com/jakewarren/tz@latest

Configuration

The tz program uses standard time zones as described here. You should specify what time zones to display by setting the TZ_LIST environment variable. The local time is always displayed first. To display your local time, the time in California, and the time Paris, you have to set TZ_LIST to US/Pacific;Europe/Paris

Zone Alias

The TZ_LIST env. variable recognizes items from the standard tz database names, but you can alias these, using a special value: use the standard name followed by , and your alias. For example:

TZ_LIST="Europe/Paris,EMEA office;US/Central,US office"

Changes in the fork

This is a fork of oz/tz that contains the following changes:

The default behavior is to quit immediately, pass in -i to enter into interactive mode
Shows the date by default.
Removes the 'What time is it?' banner.

Building

You need a recent-ish release of go with modules support:

git clone https://github.com/jakewarren/tz
cd tz
go build

Testing

go test -cover

License

The GPL3 license.

jakewarren / tz