Skip to content

kritibb/ktz-timezone-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ktz - Timezone CLI Application

ktz is a simple and efficient timezone CLI application that helps you retrieve the current time based on a given city, country, or timezone. It's perfect for quickly finding the time anywhere in the world through your terminal.


Table of Contents

  1. Installation
  2. Usage / Examples
  3. Future Plans

1. Installation

To get started with ktz, follow either one of the steps below:

  1. Install the application by running:

    $ go install github.com/kritibb/ktz@v0.1.0
  2. Or, run the following commands:

    $ git clone git@github.com:kritibb/ktz.git
    $ cd ktz
    $ sh setup_ktz.sh

2. Usage / Examples

Find Timezone by City

  • Use full name of a city:

    $ ktz lookup sydney
  • Use prefix search:

    $ ktz lookup syd
    Demo

    City prefix-search demo

Find Timezone by Country

  • Use the 3-letter country code:

    $ ktz lookup -c NPL
    Demo

    Country code demo

  • Use the 3-letter country code:

    $ ktz lookup -c NP
  • Use the prefix search:

    $ ktz lookup -c aust
    Demo

    Country prefix-search demo

Find Timezone by tz name

  • Use timezone abbreviation:

    $ ktz lookup -z pst
    Demo

    Zone abbreviation demo

  • Use the full timezone name:

    $ ktz lookup -z Asia/Kathmandu
    Demo

    Zone name demo

3. Future Plans

Here are some features that we plan to add in the future:

  • Favorite Timezones: Add specific timezones to your favorite list for quick access.
  • Remove Timezones: Remove timezones from your favorite list.
  • Display Saved Timezones: Easily view all your saved timezones in one place.

Stay tuned for more updates!

Feel free to contribute, suggest improvements, or raise issues to help us make ktz even better! 😊