1.0.0 • Published 5 months ago

crtime v1.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
5 months ago

🌍 CRTIME

A Smart CLI Tool for Time Zone Conversions with Tehran Focus

🌟 Overview

CRTIME is a command-line interface tool that makes it easy to convert times between Tehran and other time zones. Perfect for developers, remote workers, and anyone working across time zones with Iran.

✨ Features

  • 🔄 Bi-directional conversion (Tehran ↔️ Other Timezones)
  • 🎯 Common timezone quick selection
  • 🔍 Smart timezone search
  • ⌚ 24-hour format support
  • 🌐 Support for all major time zones
  • 💫 Interactive CLI interface

🚀 Installation

One-Time Run

npx crtime

Global Installation (Requires Node.js)

npm install -g crtime

Then run:

crtime

📝 Usage Guide

Converting from Tehran Time

  1. Select "Tehran time => Other timezone"
  2. Enter the time in 24-hour format (HH:mm)
  3. Choose or search for target timezone
  4. View the converted time

Converting to Tehran Time

  1. Select "Other timezone => Tehran time"
  2. Choose or search for source timezone
  3. Enter the time in 24-hour format (HH:mm)
  4. View the converted time

Common Timezones

Quick access to popular timezones:

  • Pacific Time (PST/PDT)
  • Mountain Time (MST/MDT)
  • Central Time (CST/CDT)
  • Eastern Time (EST/EDT)
  • GMT/London (GMT/BST)
  • Central Europe (CET)
  • Dubai (GST)
  • India (IST)
  • Singapore/Hong Kong
  • Japan (JST)
  • Australia Eastern (AEST)

💻 Technical Details

  • Built with Node.js
  • Uses moment-timezone for accurate conversions
  • Interactive CLI with inquirer
  • ES Modules architecture
  • Autocomplete timezone search

🔧 Dependencies

  • inquirer
  • inquirer-autocomplete-prompt
  • moment
  • moment-timezone

🐛 Bug Reports

Found a bug? Please open an issue on GitHub with:

  • Your OS version
  • Node.js version
  • Steps to reproduce
  • Expected vs actual behavior

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

✨ Acknowledgments

  • moment-timezone for timezone calculations
  • inquirer for the interactive CLI
  • The open-source community