📅 QJalaliCalendarWidget

A modern, fully RTL-ready Jalali (Persian) calendar widget for PySide6
ویجت تقویم جلالی حرفه‌ای و قابل شخصی‌سازی برای PySide6

✨ Quick Preview

❓ Why QJalaliCalendarWidget? | چرا این پروژه؟

🇬🇧 English

Qt does not provide a built-in Jalali (Persian) calendar widget.
Developers often need to implement custom solutions from scratch.

QJalaliCalendarWidget fills this gap by providing a modern, customizable, and production-ready Jalali calendar component for PySide6 applications.

🇮🇷 فارسی

🔄 Compared to QCalendarWidget | مقایسه با QCalendarWidget

🇬🇧 English

While Qt provides QCalendarWidget, it is primarily designed for the Gregorian calendar and lacks native Jalali (Persian) support.

QJalaliCalendarWidget is not just a visual modification — it is built with a fully Jalali-based internal logic and tailored specifically for Persian applications.

Key differences:

• ✅ Fully Jalali-based date system (not a conversion layer)
• ✅ Native RTL layout design
• ✅ Persian digit rendering support
• ✅ Integrated with jdatetime
• ✅ Customizable month & weekday names
• ✅ Designed specifically for Persian user experience

🇮🇷 فارسی

🌟 Features | ویژگی‌ها

🇬🇧 English

• ✅ Jalali (Persian) calendar support\
• ✅ Built with PySide6
• ✅ Right-to-left (RTL) layout support
• ✅ Customizable theme colors
• ✅ Persian / English digit modes
• ✅ Keyboard navigation
• ✅ Date range restriction (min/max)
• ✅ Custom month & weekday names
• ✅ Qt-style signals compatible with QCalendarWidget
• ✅ Modern UI design

🇮🇷 فارسی

📦 Installation | نصب

pip install qjalalicalendarwidget

🚀 Basic Usage | مثال استفاده

import sys
from PySide6.QtWidgets import QApplication

from qjalalicalendarwidget import QJalaliCalendarWidget

app = QApplication(sys.argv)


def on_date_confirmed(selected_date):
    print(selected_date.strftime("%Y/%m/%d"))
    app.quit()


def move_to_center(calendar):
    from PySide6.QtGui import QGuiApplication

    calendar.adjustSize()

    # --- Center of Screen ---
    screen = QGuiApplication.primaryScreen()
    screen_geometry = screen.availableGeometry()

    calendar.resize(calendar.sizeHint())
    x = (screen_geometry.width() - calendar.width()) // 2
    y = (screen_geometry.height() - calendar.height()) // 2

    calendar.move(x, y)


calendar = QJalaliCalendarWidget()
calendar.confirmed.connect(on_date_confirmed)

move_to_center(calendar)
calendar.show()

sys.exit(app.exec())

🎨 Customization | شخصی‌سازی

Change Digit Mode | تغییر حالت اعداد

calendar.setDigitMode("fa")  # Persian digits
calendar.setDigitMode("en")  # English digits

Set Date Range | تعیین بازه تاریخ

import jdatetime

calendar.setMinimumDate(jdatetime.date(1403, 1, 1))
calendar.setMaximumDate(jdatetime.date(1404, 12, 29))

Customize Theme Colors | تغییر رنگ‌ها

calendar.setThemeColors(
    selected_bg="#2e7d32",
    selected_fg="#ffffff",
    today_bg="#e8f5e9",
    friday_fg="#d32f2f"
)

⌨ Keyboard Navigation | ناوبری با کیبورد

🔔 Signals | سیگنال‌ها

calendar.selectionChanged.connect(...)
calendar.activated.connect(...)
calendar.currentPageChanged.connect(...)
calendar.confirmed.connect(...)
calendar.dateSelected.connect(...)

📋 Requirements | پیش‌نیازها

• Python >= 3.11
• PySide6 >= 6.6
• jdatetime >= 4.1

📄 License | مجوز

MIT License

🤝 Contributing | مشارکت

Pull requests are welcome.
For major changes, please open an issue first.

از پیشنهادها و مشارکت شما استقبال می‌شود.

🔗 Links

• GitHub: https://github.com/reza-rezvani2052/QJalaliCalendarWidget
• PyPI: https://pypi.org/project/qjalalicalendarwidget/

⭐ Support

If you find this project useful, consider giving it a ⭐ on GitHub.