کدهای پایتون برای کار با تاریخ شمسی

# فقط تاریخ فعلی شمسی
today_jalali = jdatetime.date.today()
print(f’تاریخ امروز شمسی: {today_jalali}’)

# ساخت یک تاریخ و زمان شمسی (سال، ماه، روز، ساعت، دقیقه، ثانیه)
my_jalali_datetime = jdatetime.datetime(1402, 12, 29, 23, 59, 59)
print(f’تاریخ و زمان دلخواه شمسی: {my_jalali_datetime}’)

# تبدیل میلادی به شمسی
jalali_from_miladi_date = jdatetime.date.fromgregorian(date=miladi_date)
jalali_from_miladi_datetime = jdatetime.datetime.fromgregorian(datetime=miladi_datetime)
print(f’میلادی {miladi_date} به شمسی: {jalali_from_miladi_date}’)
print(f’میلادی {miladi_datetime} به شمسی: {jalali_from_miladi_datetime}’)

# تاریخ شمسی
jalali_date = jdatetime.date(1402, 8, 4)
jalali_datetime = jdatetime.datetime(1402, 8, 4, 14, 30, 0)

# تبدیل شمسی به میلادی
miladi_from_jalali_date = jalali_date.togregorian()
miladi_from_jalali_datetime = jalali_datetime.togregorian()
print(f’شمسی {jalali_date} به میلادی: {miladi_from_jalali_date}’)
print(f’شمسی {jalali_datetime} به میلادی: {miladi_from_jalali_datetime}’)

# فرمت‌های مختلف
print(f’تاریخ کامل: {now_jalali.strftime(‘%Y/%m/%d – %H:%M:%S’)}’) # 1402/08/04 – 14:30:00
print(f’روز هفته: {now_jalali.strftime(‘%A’)}’) # پنج‌شنبه
print(f’نام ماه: {now_jalali.strftime(‘%B’)}’) # آبان
print(f’سال کوتاه: {now_jalali.strftime(‘%y’)}’) # 02

# ترکیب با متن فارسی (مثال ساده تر برای نمایش فارسی)
# توجه: استفاده از strftime برای نام ماه و روز هفته بهترین راه است
print(f’امروز {now_jalali.strftime(‘%A’)}، {now_jalali.day} {now_jalali.strftime(‘%B’)} ماه {now_jalali.year} سال است.’)

# ساخت تاریخ شمسی
my_jalali = JalaliDate(1402, 8, 4)
print(f’تاریخ شمسی دلخواه (persian-calendar): {my_jalali}’)

# تبدیل شمسی به میلادی
miladi_from_jalali = my_jalali.to_gregorian()
print(f’تاریخ شمسی {my_jalali} به میلادی: {miladi_from_jalali}’)

# اضافه کردن روز
future_date = current_date + timedelta(days=10)
print(f’۱۰ روز بعد: {future_date}’)

# کم کردن روز
past_date = current_date – timedelta(days=5)
print(f’۵ روز قبل: {past_date}’)

# اضافه کردن ماه (نیاز به منطق دستی یا پکیج‌های کمکی)
# jdatetime مستقیما timedelta برای ماه نداره، باید سال و ماه رو تنظیم کنی.
# یک راه حل برای اضافه کردن ماه:
def add_months_jalali(d, months):
year = d.year
month = d.month + months
while month > 12:
month -= 12
year += 1
while month <= 0:
month += 12
year -= 1
try:
return jdatetime.date(year, month, d.day)
except ValueError:
# مثلا اگر روز 31 باشه و ماه 30 روزه باشه، روز رو به آخر ماه تغییر میدیم
return jdatetime.date(year, month, 1).replace(day=jdatetime.date(year, month, 1).daysinmonth)

future_month = add_months_jalali(current_date, 3)
print(f’۳ ماه بعد: {future_month}’)

# اضافه کردن سال
future_year = jdatetime.date(current_date.year + 1, current_date.month, current_date.day)
print(f’۱ سال بعد: {future_year}’)

delta = date2 – date1

print(f’تاریخ اول: {date1}’)
print(f’تاریخ دوم: {date2}’)
print(f’اختلاف: {delta}’)
print(f’اختلاف بر حسب روز: {delta.days}’)
print(f’اختلاف بر حسب ثانیه: {delta.total_seconds()}’)

راه حل:

1. تغییر Encoding فایل پایتون: مطمئن شو که فایل پایتون رو با UTF-8 ذخیره کردی. معمولاً با افزودن این خط در ابتدای فایل مشکل حل میشه:
   برای کپی کلیک کنید
   
# -*- coding: utf-8 -*-

2. تنظیم Encoding ترمینال: در CMD ویندوز می‌تونی با `chcp 65001` encoding رو به UTF-8 تغییر بدی. تو لینوکس و macOS معمولاً این مشکل کمتر پیش میاد.
3. استفاده از `.decode()` و `.encode()`: در موارد خاص، ممکنه نیاز باشه رشته‌های فارسی رو به صورت دستی encode یا decode کنی، اما با رعایت مورد اول، کمتر به این کار نیاز پیدا می‌کنی.

راه حل:

1. آپدیت `pip`: همیشه `pip` رو به روز نگه دار:
   برای کپی کلیک کنید
   
python -m pip install --upgrade pip

2. محیط مجازی (Virtual Environment): همیشه از محیط مجازی استفاده کن. این کار از تداخل پکیج‌ها جلوگیری می‌کنه:
   برای کپی کلیک کنید
   
python -m venv myenv
./myenv/Scripts/activate # Windows
source myenv/bin/activate # Linux/macOS
pip install jdatetime


راه حل:

1. نصب `pytz`:
   برای کپی کلیک کنید
   
pip install pytz

2. استفاده از تایم‌زون:
   برای کپی کلیک کنید
   
import jdatetime
import pytztehran_tz = pytz.timezone(‘Asia/Tehran’)

   # تاریخ و زمان فعلی با تایم‌زون تهران
   now_tehran = jdatetime.datetime.now(tehran_tz)
   print(f’زمان فعلی در تهران: {now_tehran}’)

   # تبدیل یک تاریخ ناآگاه به آگاه از تایم‌زون
   naive_dt = jdatetime.datetime(1402, 8, 4, 10, 0, 0)
   aware_dt = tehran_tz.localize(naive_dt)
   print(f’تاریخ با تایم‌زون: {aware_dt}’)

آیا jdatetime از روزهای کبیسه شمسی پشتیبانی می‌کند؟

بله، کتابخانه jdatetime به طور کامل از تقویم شمسی از جمله سال‌های کبیسه پشتیبانی می‌کند و محاسبات را به درستی انجام می‌دهد. شما نیازی به مدیریت دستی این جزییات ندارید.

بهترین روش برای ذخیره تاریخ‌ها در دیتابیس چیست؟

توصیه اکید این است که تاریخ‌ها را در دیتابیس به فرمت میلادی (Gregorian) و ترجیحاً با تایم‌زون UTC ذخیره کنید. این کار سازگاری با سیستم‌های جهانی و ابزارهای مختلف را تضمین می‌کند. تبدیل به شمسی فقط باید هنگام نمایش به کاربر نهایی انجام شود.

آیا می‌توانم با jdatetime ساعت و دقیقه را هم مدیریت کنم؟

بله، jdatetime.datetime علاوه بر تاریخ، امکان مدیریت ساعت، دقیقه، ثانیه و حتی میکروثانیه را نیز فراهم می‌کند. این کلاس تمام قابلیت‌های datetime.datetime پایتون را برای تقویم شمسی ارائه می‌دهد.

برای پروژه‌های Django یا Flask، رویکرد خاصی برای تاریخ شمسی وجود دارد؟

در فریم‌ورک‌هایی مثل Django یا Flask، می‌توانید از jdatetime در لایه View یا Template استفاده کنید. برای مدل‌ها، بهتر است فیلدهای تاریخ را از نوع استاندارد DateTimeField یا DateField تعریف کرده و در زمان نمایش یا پردازش ورودی، تبدیل به شمسی را انجام دهید. برای Django، پکیج‌هایی مانند django-jalali هم وجود دارند که ادغام jdatetime را ساده‌تر می‌کنند.