![](https://i.imgur.com/ZebplfT.png)
Timezones CLI
CLI toolkit for timezones:zap:
What can you do with timezones-cli
? :zap:
- Search for date and time based on city, country, or timezones.
- Manage dashboard for timezones you frequently view.
- Get UTC date and time based on your local timezone or any timezones.
Contents
Installation
$ pip3 install timezones-cli
To run this CLI using Docker, check Run using Docker :whale:.
NOTE: List of country codes or timezone names :earth_asia:
Use -t
flag to toggle 24 hours format.
Usage
Search for local date time
You can use short country code like 'AE', 'RU', 'US' and so on.
You can search via city like: 'Paris', 'London', 'Moscow', 'Chicago' and so on.
$ tz search "us"
$ tz search "Nepal"
$ tz search "Paris"
Demo
Search based on timezone abbreviations
$ tz get "pst"
$ tz get "ist"
$ tz get "est"
$ tz get "cst"
Demo
Add timezones
Timezones added to the config file are treated as the default timezones which is triggered by the tz show
command.
file is stored at ~/.tz-cli
$ tz add "Asia/Kathmandu"
Demo
---
Remove timezones
There are two ways for removing timezones from the config file. Using the --interactive
mode and passing the the --name
flag.
$ tz remove -i
$ tz remove --name "Asia/Kathmandu"
Demo
Show local datetime of all saved timezones
$ tz show
Demo
---
Select a single timezone from defaults
$ tz select
Demo
Get UTC time
Get UTC time based on current system time.
tz utc --help
$ tz utc
Get UTC time based on specified time and timezone.
$ tz utc <time> <timezone>
$ tz utc "11:45PM" "Asia/Kathmandu"
Demo
Run using Docker :whale:
docker pull ghcr.io/yankeexe/timezones-cli:latest
Verify signature of the image: requires cosign.
COSIGN_EXPERIMENTAL=true cosign verify ghcr.io/yankeexe/timezones-cli:latest
Create a config file manually first.
$ touch ~/.tz-cli
$ docker run --rm -it -v ${HOME}/.tz-cli:/home/tz/.tz-cli ghcr.io/yankeexe/timezones-cli search us
For convenience you can add alias of the command to your shell config:
$ echo "alias tz='docker run --rm -it -v ${HOME}/.tz-cli:/home/tz/.tz-cli ghcr.io/yankeexe/timezones-cli'" >> ~/.bashrc
$ source ~/.bashrc
$ echo "alias tz='docker run --rm -it -v ${HOME}/.tz-cli:/home/tz/.tz-cli ghcr.io/yankeexe/timezones-cli'" >> ~/.zshrc
$ source ~/.zshrc
$ tz search Nepal
For local debugging: Use the make run
command followed by the command you want to run against the tz
binary.
$ make run cmd="get ist"
Demo
Contributing
For guidance on setting up a development environment and how to make a contribution to timezones-cli
, see the contributing guidelines.