فهرست مستندات پروژه
آشنایی با Daynum
انتخاب تقویم و پیدا کردن راهنمای مناسب برای کار شما.
Daynum یک کتابخانه تغییرناپذیر PHP برای تبدیل، نمایش و محاسبه تاریخ در تقویم میلادی، شمسی و دو نوع تقویم قمری است. به PHP 8.1 یا بالاتر نیاز دارد، وابستگی Composer برای اجرا ندارد و بدون ext-intl کار می‌کند.
وضعیت انتشار
این راهنماها همراه نسخه v1.0.0-beta.4 به تاریخ ۸ اکتبر ۲۰۲۶ هستند. این نسخه آزمایشی است و هنوز نسخه پایدار 1.0 نیست. راهنماهای دوزبانه، بررسی سخت‌گیرانه‌تر AM/PM و اختلاف ساعت تکراری و بهبود تطبیق نام‌ها در این نسخه قرار دارند. راهنمای parsing رفتارهای اضافه‌شده در beta.4 را مشخص می‌کند؛ beta.3 این تغییرات را ندارد. changelog نسخه را ببینید.
از کجا شروع کنیم
- نصب و اجرای اولین مثال.
- آشنایی با مقدار تاریخ، view و تبدیل تقویم.
- نمایش تاریخ با زبان دلخواه یا خواندن ورودی کاربر.
- اضافه کردن ماه، مقایسه تاریخ و پیدا کردن ابتدا و انتهای بازه.
- تبدیل منطقه زمانی و محاسبه زمان سپریشده.
- ذخیره تاریخ، مدیریت خطا و مثالهای کاربردی.
- مهاجرت از morilog/jalali، مرجع API و الگوریتمها و محدودیتها.
انتخاب تقویم
| تقویم | متدهای ساخت و نمایش | سال‌های مجاز برای ساخت تاریخ |
|---|---|---|
| میلادی | fromGregorian() / gregorian() | -9999 تا 9999، شامل سال صفر |
| شمسی | fromJalali() / jalali() | 1 تا 3177 |
| قمری امالقری | fromHijri() / hijri() | 1300 تا 1600 قمری |
| قمری محاسباتی | fromHijriCivil() / hijriCivil() | 1 تا 9666 قمری |
CivilDateTime روز، ساعت محلی و یک برچسب اختیاری منطقه زمانی را نگه می‌دارد. تبدیل تقویم، ساعت و این برچسب را حفظ می‌کند و زمان یک لحظه را به منطقه زمانی دیگری تبدیل نمی‌کند. برای این کار از DateTimeImmutable در PHP یا timestamp استفاده کنید؛ جزئیات در راهنمای منطقه زمانی آمده است.