Skip to main content

A simple CLI to get the current time in any city worldwide.

Project description

โฐ timenow

PyPI version Python Version License: MIT

timenow is a lightweight and fast command-line tool by Ninza Panda that instantly shows the current date and time โ€” right in your terminal.
Perfect for quick time checks or as part of your scripts.


๐Ÿš€ Features

  • ๐Ÿ“… Displays the current local date and time
  • ๐ŸŒ Optional UTC time output
  • ๐Ÿ’ก Zero configuration โ€” just run the command
  • ๐Ÿ–ฅ Works on Windows, macOS, and Linux
  • โšก Global command after installation

๐Ÿ“ฆ Installation

Prerequisite: Python 3.7+ installed and pip available.

Install from PyPI:

pip install timenow

Upgrading to the latest version:

pip install โ€“upgrade timenow


๐Ÿ’ป Usage

Once installed, simply run:

timenow -tokyo

Example output: โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•— โ•‘ ๐ŸŒ WORLD TIME CLI ๐Ÿ• โ•‘ โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

โณ Searching for location: tokyo... โœ… Found: ๆฑไบฌ้ƒฝ, ๆ—ฅๆœฌ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ โณ Fetching current time...

โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ”‚ ๐Ÿ“ Location: ๆฑไบฌ้ƒฝ, ๆ—ฅๆœฌ โ”‚ โ”‚ โ”‚ โ”‚ ๐Ÿ• Current Time: โ”‚ โ”‚ 07:16:23 PM โ”‚ โ”‚ โ”‚ โ”‚ ๐ŸŒ Timezone: Asia/Tokyo โ”‚ โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ


๐Ÿ“œ License

This project is licensed under the MIT License โ€“ see the LICENSE file for details.

MIT License Copyright (c) 2025 Ninza Panda


๐Ÿ‘ค Author

Ninza Panda
๐Ÿ’Œ Email: ninzaapanda.com
๐ŸŒ Website: https://ninzapanda.com


โญ If you like timenow, consider giving it a star on GitHub and sharing it with your friends!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

timenow_cli-1.0.0.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

timenow_cli-1.0.0-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

Details for the file timenow_cli-1.0.0.tar.gz.

File metadata

  • Download URL: timenow_cli-1.0.0.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for timenow_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 d87de51c4a255167b132446a9dadecf9d7f7d5a7b1cdb7738aa09ff1bbb2ca53
MD5 b5f866a1f5132fd63e3aee28a1d40614
BLAKE2b-256 d79129b62ba404516148052b1b766be429fb99f6870c6e5f85d32dec3dbabc2e

See more details on using hashes here.

File details

Details for the file timenow_cli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: timenow_cli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 6.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for timenow_cli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6e3da8bc0da15f6522ccc21b60ce7277ad6c27a6f972885f1b79be43c03049c2
MD5 7a47b4c994c6402393bac504bc8ea50a
BLAKE2b-256 3afcc747da746bb8ba4caa675533d940eb929fb43a47ca7f2ae1b7f87f83e6c0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page