Skip to content

Latest commit

 

History

History
109 lines (83 loc) · 2.74 KB

README.md

File metadata and controls

109 lines (83 loc) · 2.74 KB

worldtimebuddy

Get current time for all possible timezone using CLI (exclusively for developers)

Version - 0.1.3

Publish worldtimebuddy

Usage: worldtimebuddy [OPTIONS]

  Display current time for all timezones, major timezones, or a specific
  timezone.

Options:
  --format TEXT         DateTime format string
  --major               Show only major timezones
  -tz, --timezone TEXT  Show time for a specific timezone
  --list                List all available timezones
  --delta TEXT          Add or subtract time from a particular timezone
  --help                Show this message and exit.

Installation (PyPI):

pip3 install worldtimebuddy

Installation (Development):

  1. Clone the repository locally
git clone https://github.com/dubesar/worldtimebuddy.git
cd worldtimebuddy
  1. Run the following code to install dependencies and worldtimebuddy
pip install -r requirements.txt
python3 setup.py build
python3 setup.py install

Usage:

  1. Get all the timezones
> worldtimebuddy

Africa/Abidjan                 2024-10-06 13:49:11
Africa/Accra                   2024-10-06 13:49:11
....
  1. Get all timezone in particular format
> worldtimebuddy --format '%A, %B %d, %Y %I:%M %p %Z'

Africa/Abidjan                 Sunday, October 06, 2024 01:49 PM GMT
Africa/Accra                   Sunday, October 06, 2024 01:49 PM GMT
Africa/Addis_Ababa             Sunday, October 06, 2024 04:49 PM EAT
...
  1. Get major timezones

Currenlty only IST/PST/PDT/UTC by default. But user can set major timezones in their environment with name MAJOR_TIMEZONES, this tool will pick up those as the major versions.

> export MAJOR_TIMEZONES=["UTC","Asia/Kolkata"]
> worldtimebuddy --major

UTC                            2024-10-06 13:50:26
PDT                            2024-10-06 06:50:26

##Without the environment variable

> worldtimebuddy --major

UTC                            2024-10-06 13:50:26
PDT                            2024-10-06 06:50:26
Asia/Kolkata                   2024-10-06 19:20:26
  1. Listing all timezones
> worldtimebuddy --list

Africa/Abidjan
Africa/Accra
Africa/Addis_Ababa
Africa/Algiers
...
  1. Getting a particular timezone
> worldtimebuddy --timezone UTC
UTC                            2024-10-06 19:33:35

> worldtimebuddy --timezone JST
Asia/Tokyo                     2024-10-07 04:33:35
...
  1. Getting a difference of time from a particular timezone
    (supported time formats: +/- min, hr, day)
> worldtimebuddy --timezone UTC --delta +2hr
UTC                            2024-10-06 20:43:35
...