TimeBridge

Universal date converter for Gregorian, Persian, and Hijri calendars.

TimeBridge is a lightweight bilingual web app for converting dates between:

• Gregorian
• Persian / Jalali / Shamsi
• Hijri / Islamic / Qamari

It is built as a static client-side project with plain JavaScript and Tailwind CSS, with no external date-conversion libraries.

Links

• Preview: https://basemax.github.io/TimeBridge/
• Repository: https://github.com/BaseMax/TimeBridge

Features

• Bidirectional conversion between Gregorian, Persian, and Hijri dates
• Bilingual interface: English and Persian
• Light and dark theme toggle
• Language and theme persistence with localStorage
• Localized digits support
• Persian digits for Jalali dates in Persian mode
• Arabic digits for Hijri dates in Persian mode
• Automatic normalization of Persian and Arabic numerals during typing
• No external calendar libraries
• Responsive UI built with Tailwind CSS

Demo

Open the live preview here:

https://basemax.github.io/TimeBridge/

Project Structure

TimeBridge/
├─ index.html
├─ script.js
├─ README.md
└─ LICENSE

How It Works

The application uses custom conversion algorithms for:

• Gregorian to Jalali
• Jalali to Gregorian
• Gregorian to Hijri
• Hijri to Gregorian

The UI updates all three calendars whenever one input changes.

Usage

Online

Visit the preview URL:

https://basemax.github.io/TimeBridge/

Local

Clone the repository and open index.html in a browser.

git clone https://github.com/BaseMax/TimeBridge.git
cd TimeBridge

Then open index.html directly, or serve it with any static server.

Example with Python:

python -m http.server 8000

Then open:

http://localhost:8000

Supported Input Behavior

• Gregorian input uses the native browser date field
• Persian and Hijri inputs accept typed dates in YYYY/MM/DD
• Persian and Arabic numerals are normalized automatically
• In Persian mode:
  • Jalali fields are rendered with Persian digits
  • Hijri fields are rendered with Arabic digits

Technologies

• HTML5
• Tailwind CSS via CDN
• Vanilla JavaScript
• Google Fonts: Vazirmatn

SEO

The project includes basic SEO and social metadata, including:

• title and description
• Open Graph tags
• Twitter card tags
• canonical URL
• bilingual metadata support

Why TimeBridge?

TimeBridge is useful for users who need to work across multiple calendar systems, especially in Persian and Arabic contexts where Gregorian, Jalali, and Hijri dates are commonly used together.

Persian Summary

ابزار TimeBridge ابزاری سبک و دو زبانه برای تبدیل تاریخ بین این تقویم‌ها است:

• میلادی
• هجری شمسی
• هجری قمری

ویژگی‌ها:

• تبدیل دوطرفه تاریخ‌ها
• پشتیبانی از زبان فارسی و انگلیسی
• ذخیره زبان و تم در localStorage
• پشتیبانی از ارقام فارسی و عربی
• بدون استفاده از کتابخانه‌های آماده تبدیل تاریخ
• رابط کاربری واکنش‌گرا با Tailwind CSS

پیش‌نمایش:

https://basemax.github.io/TimeBridge/

مخزن پروژه:

https://github.com/BaseMax/TimeBridge

Contributing

Issues and pull requests are welcome.

If you want to improve conversion accuracy, UX, accessibility, or localization, feel free to contribute.

License

This project is licensed under the terms of the LICENSE file in this repository.

Copyright 2025, Seyyed Ali Mohammadiyeh (MAX BASE)