مرجع تقویم (PHP Calendar)
این صفحه «مرجع تقویم PHP» است. تمرکز ما روی توابع تقویم است. افزونه Calendar تبدیل تقویم ها را ساده می کند. «شمارش روزهای ژولیَن (Julian Day Count)» مبناست. این با «تقویم ژولیَن» یکی نیست.
مرجع تقویم PHP چیست؟
اینجا توابعی داریم که بین تقویم ها تبدیل می کنند. ابتدا تاریخ به شمارش ژولیَن تبدیل می شود. سپس به تقویم دلخواه برمی گردد. این روند خطا را کم می کند.
نصب و فعال سازی
برای لینوکس یا مک باید PHP را با --enable-calendar کامپایل کنی. در ویندوز، این افزونه به صورت پیش فرض فعال است.
توابع مهم تقویم
- cal_days_in_month(): تعداد روزهای ماه را می دهد.
- cal_from_jd(): تبدیل شمارش ژولیَن به تاریخ تقویمی.
- cal_info(): اطلاعات تقویم انتخابی را برمی گرداند.
- cal_to_jd(): تبدیل تاریخ تقویمی به شمارش ژولیَن.
- easter_date(): زمان یونیکس عید پاک آن سال.
- easter_days(): فاصله عید پاک از 21 مارس.
- frenchtojd() / jdtofrench(): تبدیل جمهوری فرانسه و برعکس.
- gregoriantojd() / jdtogregorian(): تبدیل گرگوری و برعکس.
- jdtojewish() / jewishtojd(): تبدیل عبری و برعکس.
- jdtojulian() / juliantojd(): تبدیل ژولیَن و برعکس.
- jddayofweek(): نام یا شماره روز هفته.
- jdmonthname(): نام ماه را برمی گرداند.
- jdtounix() / unixtojd(): تبدیل ژولیَن و یونیکس.
ثوابت از پیش تعریف شده
نمونه ها: CAL_GREGORIAN، CAL_JULIAN، CAL_JEWISH، CAL_FRENCH. همچنین ثابت های نام روز و ماه موجودند. برخی ثابت های عید پاک از PHP 4.3 افزوده شده اند.
گام های عملی سریع
- بررسی فعال بودن افزونه Calendar.
- تاریخ را با cal_to_jd() به ژولیَن تبدیل کن.
- با یکی از توابع jdto* به تقویم هدف برو.
نکته: شمارش ژولیَن فقط شمارش روزهاست. تقویم ژولیَن سیستم نام گذاری تاریخ است.
لینک های داخلی
برای مرور سریع تر ببین: مرجع تقویم PHP، و مرجع تاریخ PHP.
جمع بندی سریع
- پایه تبدیل، شمارش ژولیَن است.
- اول به ژولیَن، بعد به تقویم هدف.
- در ویندوز، افزونه آماده است.
- تابع های cal_* و jd* هسته کارند.