آیا به نصب برنامه خاص نیاز است؟
نسخه تحت ویندوز PHP بصورت استاندارد و پیش فرض تمامی توابع تقویم را شامل شده و بدون نیاز به تغییر خاص کار میکند.اما اگر از نسخه لینوکس PHP استفاده میکنید باید خروجی را با نسخه enable calendar آن کامپایل کنید .
لیست توابع اصلی و مهم کار با تقویم calendar در PHP :
در جدول زیر ، توابع مهم و پر کاربرد کار با تقویم در php را معرفی کرده ایم . برای دریافت اطلاعات بیشتر و مثال های عملی ، بر روی نام هر تابع کلیک نمایید :
| نام تابع | کاربرد |
| cal_days_in_month ( ) | این تابع تعداد روزهای یک ماه خاص از یک تقویم و سال مورد نظر را برمیگرداند . |
| ccal_from_jd ( ) | این تابع یک روز داه شده از تقویم Julian را به هر فرمت دیگر تقویم تبدیل میکند . |
| ccal_to_jd ( ) | این تابع یک تاریخ معین را گرفته و سپس تعداد روزهای سپری شده در تقویم Julian از آن روز خاص را حساب میکند . |
| GregorianToJD ( ) | این تابع یک تاریخ معین تقویم گریگوری یا مسیحی را به تعداد روزهای سپری شده از اول تقویم ژولیانی(Julian day count) تبدیل میکند . |
| JDDayOfWeek ( ) | این تابع نام روز جاری از هفته را نمایش میدهد . |
| JDMonthName ( ) | این تابع نام ماه جاری از سال را نمایش میدهد . |
تابع ( ) cal_days_in_month :
این تابع تعداد روزهای یک ماه مورد نظرتان ، مربوط به یک سال و تقویم خاص را نشان میدهد .
برای مثال فرض کنید میخواهید بدانید ماه july در سال 2005 در تقویم ژولیانی چند روز بوده است .
شکل کلی استفاده از این تابع به صورت زیر است :
| Syntax | cal_days_in_month ( calendar , month , year ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
|
این پارامتر تقویم مورد نظر را مشخص میکند. استفاده از این پارامتر اجباری است . |
calendar |
|
این پارامتر ماه مورد نظر را مشخص میکند. استفاده از این پارامتر اجباری است . |
month |
|
این پارامتر سال مورد نظر را مشخص میکند. استفاده از این پارامتر اجباری است . |
year |
مثال : در مثال زیر ، نحوه استفاده از تابع ( ) cal_days_in_month را در عمل نمایش داده ایم . در مثال زیر با استفاده از تابع ( ) cal_days_in_month تعداد روزهای ماه دهم از سال 2005 را در تقویم ژولیانی را نمایش داده ایم :
| Example | |
|
< ? php $d = cal_days_in_month ( CAL_GREGORIAN , 10 , 2005 ) ; echo ( " There was $d days in October 2005 " ) ; ? > |
کد |
| There was 31 days in October 2005 | خروجی |
تابع ( ) cal_from_jd :
این تابع یک روز معین از تقویم ژولیانی را به فرمت هر تقویم مورد نظر دیگر ، تبدیل میکند.
برای مثال فرض کنید میخواهید یک تاریخ در تقویم ژولیانی را به تاریخ آن در تقویم مسیحی تبدیل کنید .
شکل کلی استفاده از این تابع به صورت زیر است :
| Syntax | cal_from_jd ( jd , calendar ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
|
این پارامتر تعداد روزهای سپری شده مورد نظر شما در تقویم ژولیانی را تعیین میکند . استفاده از این پارامتر اجباری است . |
jd |
|
این پارامتر تقویم مقصد که میخواهید تاریخ جاری را به فرمت آن تبدیل کند را مشخص میکند .
|
calendar |
مثال : در مثال زیر ، نحوه استفاده از تابع ( ) cal_from_jd را در عمل نمایش داده ایم . در مثال زیر ابتدا یک تاریخ خاص را در متغیر d$ ذخیره کرده ایم . سپس با استفاده از تابع ( ) cal_from_jd آن را به روز مربوطه در تقویم گریگوری تبدیل کرده ایم :
| Example | |
|
< ? php $d = unixtojd ( mktime ( 0,0,0,1,18,2006 ) ) ; print_r ( cal_from_jd ( $d , CAL_GREGORIAN ) ) ; ? > |
کد |
|
Array ( [date] => 1/18/2006 [month] => 1 [day] => 18 [year] => 2006 [dow] => 3 [abbrevdayname] => Wed [dayname] => Wednesday [abbrevmonth] => Jan [monthname] => January ) |
خروجی |
تابع ( ) cal_to_jd :
این تابع یک تاریخ معین را گرفته ، سپس تعداد روزهای سپری شده از اول تقویم ژولیانی تا روز مورد نظر را نمایش میدهد.
اولین روز در تقویم ژولیانی اول فوریه سال 4713 قبل از میلاد مسیح است.
شکل کلی استفاده از این تابع به صورت زیر است :
| Syntax | cal_to_jd ( calendar , month , day , year ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
|
این پارامتر تقویم مورد استفاده را مشخی می سازد .
استفاده از این پارامتر اجباری است . |
calendar |
|
این پارامتر ماه تاریخ مورد نظر را تعیین میکند. استفاده از این پارامتر اجباری است . |
month |
|
این پارامتر روز تاریخ مورد نظر را تعیین میکند. استفاده از این پارامتر اجباری است . |
day |
|
این پارامتر سال تاریخ مورد نظر را تعیین میکند. استفاده از این پارامتر اجباری است . |
year |
مثال : در مثال زیر ، نحوه استفاده از تابع ( ) cal_to_jd را در عمل نمایش داده ایم . در مثال زیر تعداد روزهای سپری شده از ابتدای تقویم ژولیانی تا یک تاریخ خاص را نمایش داده ایم :
| Example | |
|
< ? php $d=cal_to_jd ( CAL_GREGORIAN , 10 , 03 ,2005 ) ; echo ( $d ) ; ? > |
کد |
| 2453647 | خروجی |
تابع ( ) JDDayOfWeek :
این تابع یک تاریخ معین را گرفته و نام روز آن تاریخ را برمیگرداند.
شکل کلی استفاده از این تابع به صورت زیر است :
| Syntax | jddayofweek ( jd , mode ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
|
این پارامتر تعداد روزهای سپری شده از تاریخ اول تقویم ژولیایی را تعیین میکند . استفاده از این پارامتر اجباری است . |
jd |
|
این پارامتر خروجی تابع را مشخص میکند. اینکه خروجی بصورت حروفی(نام روز) و یا عددی (شماره روز در هفته) باشد. انواع مقادیر ممکن برای این پارامتر عبارتند از : 0: این مقدار مقدار پیش فرض است و باعث میشود تا خروجی تابع شماره روز در هفته را برگرداند . ( 0 برای یکشنبه ، 1 برای دوشنبه ، ... ) 1 : قرار دادن مقدار 1 باعث میشود تا تابع نام روز در هفته را برگرداند. استفاده از این پارامتر اختیاری است . |
jd |
مثال : در مثال زیر ، نحوه استفاده از تابع ( ) JDDayOfWeek را در عمل نمایش داده ایم . در مثال زیر ابتدا یک تاریخ خاص را در متغیر jd$ ذخیره کرده ایم . سپس با استفاده از تابع ( ) JDDayOfWeek ، نام روز آن تاریخ را در خروجی چاپ کرده ایم :
| Example | |
|
< ? php $jd = cal_to_jd (CAL_GREGORIAN , date("m") , date("d") , date("Y") ) ; echo ( jddayofweek ( $jd , 1 ) ) ; ? > |
کد |
| Thursday | خروجی |
تابع ( ) JDMonthName :
این تابع یک تاریخ معین را دریافت کرده و نام ماه مربوط به آن تاریخ را نشان میدهد.
برای مثال میخواهید ماه تاریخ بخصوصی را نمایش دهید.
شکل کلی استفاده از این تابع به صورت زیر است :
| Syntax | jdmonthname ( jd , mode ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
|
این پارامتر تعداد روزهای سپری شده از تاریخ اول تقویم ژولیایی را تعیین میکند . استفاده از این پارامتر اجباری است . |
jd |
|
این پارامترها نحوه خروجی نام ماه را تعیین میکند که مثلا نام کامل باشد و یا بصورت حروف اختصاری. انواع مقادیر قابل استفاده در این پارامتر عبارتند از : 0 : نام ماه بصورت اختصاری و بر مبنای تقویم مسیحی (Jan, Feb, Mar, etc ) . 1 : نام کامل ماه بر مبنای تقویم مسیحی (January, February, March, etc ) . 2 : نام ماه بصورت اختصاری و بر مبنای تقویم ژولیانی (Jan, Feb, Mar, etc ) . 3 : نام کامل ماه بر اساس تقویم ژولیانی (January, February, March, etc ) . استفاده از این پارامتر اختیاری است . |
mode |
مثال : در مثال زیر ، نحوه استفاده از تابع ( ) JDMonthName را در عمل نمایش داده ایم . در مثال زیر ابتدا یک تاریخ خاص را در متغیر jd$ ذخیره کرده ایم . سپس با استفاده از تابع ( ) JDMonthName ، نام ماه آن تاریخ را در خروجی چاپ کرده ایم :
| Example | |
|
< ? php $jd = cal_to_jd (CAL_GREGORIAN , date("m") , date("d") , date("Y") ) ; echo ( jdmonthname ( $jd , 1 ) ) ; ? > |
کد |
| January | خروجی |
منبع: developer1
