Skip to content
CyberLoop-devPublic

About

Convert a meeting date and time across IANA time zones, showing UTC offsets and day changes with daylight-saving support.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TZ Grid banner Animated project title

Convert a meeting date and time across IANA time zones, showing UTC offsets and day changes with daylight-saving support.

MIT license Top language Stars Last commit

Timezone conversion illustration

🎯 Overview

TZ Grid converts one local meeting time into several target time zones using Python's IANA timezone database. It shows each local date, time, UTC offset, and whether the conversion lands on the previous or next day. Daylight-saving transitions are handled by zoneinfo.

✨ Features

  • 🌍 Converts one source time into multiple target zones.
  • 🕰️ Uses IANA timezone names such as Europe/Berlin and Asia/Tehran.
  • 📆 Shows date changes across time zones.
  • ☀️ Applies daylight-saving offsets for the selected date.
  • ⚠️ Detects nonexistent local times and explains ambiguous ones.

🎬 Demo

python main.py --date 2026-11-16 --time 09:00 --from-zone Asia/Tehran --to-zones Europe/Berlin,America/New_York,Asia/Tokyo

🚀 Quick Start

python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt
python main.py --date YYYY-MM-DD --time HH:MM --from-zone Asia/Tehran --to-zones Europe/Berlin,America/New_York

🧰 Tech Stack

  • Python 3.10+ standard library
  • zoneinfo and datetime
  • tzdata package for hosts without a system IANA timezone database

🗂️ Folder Structure

tz-grid/
├── main.py
├── requirements.txt
└── assets/
    └── illustration.svg

🧭 Roadmap

  • Add a multi-date weekly meeting grid.
  • Add CSV output for sharing with teams.
  • Add a small interactive local web view.

🤝 Contributing

Issues and pull requests are welcome. Include the source date, time, timezone names, and expected conversion when reporting a bug.

📄 License

Released under the MIT License. See LICENSE.

Animated wave footer

About

Convert a meeting date and time across IANA time zones, showing UTC offsets and day changes with daylight-saving support.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages