آموزش کار با تابع ()date_format در PHP
تابع ()date_format در PHP مقدار تاریخ را در قالب پارامتر ورودی دریافت کرده و آن را بر اساس فرمت ارائه شده، قالب دهی می کند.
دستور استفاده از تابع ()date_format در PHP
string date_format ( DateTime $object, string $format )
string DateTime::format ( string $format )
شرح کاربرد تابع ()date_format در PHP
این توابع مقدار تاریخ را در قالب پارامتر ورودی $object دریافت کرده و آن را بر اساس فرمت ارائه شده، $format، قالب دهی می کند.
این دو تابع، کاربردی یکسان داشته و در مثال زیر می توانند جایگزین یکدیگر شوند.
پارامترهای ارسالی به تابع ()date_format در PHP
شماره
پارامتر مربوطه و شرح کاربرد آن
1
object(پارامتر الزامی)
یک آبجکت DateTime که به عنوان آرگومان به توابع مربوطه ارسال شده و دربردارنده ی مقدار تاریخ می باشد.
یک آبجکت DateTime که به عنوان آرگومان به توابع مربوطه ارسال شده و دربردارنده ی مقدار تاریخ می باشد.
2
format(پارامتر الزامی)
این تابع نحوه ی فرمت دهی خروجی را مشخص می کند:
این تابع نحوه ی فرمت دهی خروجی را مشخص می کند:
- d – نشانگر شماره ی روز ماه (از 01 تا 31) می باشد.
- D – نشانگر اسم روز به صورت مختصر (سه حرف) می باشد.
- j – نشانگر شماره ی روز ماه بدون صفر آغازین (1 تا 31) می باشد.
- l – نشانگر اسم روز به صورت کامل می باشد.
- N – نماد عددی روز هفته بر اساس استاندارد ISO-8601 (1 برای Monday یا دوشنبه و 7 برای Sunday یا یکشنبه).
- S – پسوند ترتیبی روز ماه متشکل از دو کاراکتر که st، nd، rd و th.
- w – نماد عددی روز هفته (0 برای یکشنبه و 6 به نشانه ی شنبه).
- z – شماره ی روز سال (از 0 تا 365).
- W – شماره ی روز هفته از سال مورد نظر بر اساس استاندارد ISO-8601 (هفته از دوشنبه / Monday شروع می شود).
- F – اسم کامل روز ماه به صورت متن (/Januaryژانویه تا December/دسامبر).
- m – نماد عددی روز از یک ماه (از 01 تا 12)
- M – نماد متنی اسم روز ماه به صورت مختصر (مشتکل از سه حرف).
- n – نماد عددی یک ماه، بدون صفر آغازین (از 1 تا 12).
- t – تعداد روزهای موجود در ماه مورد نظر.
- L – نشانگر سال کبیسه است (چناچه سال مورد نظر کبیسه محسوب شود مقدار 1 و در غیر این صورت 0).
- o – شماره ی سال مورد نظر بر اساس استاندارد ISO-8601.
- Y – شماره ی سال در قالب 4 عدد (برای مثال 2017) .
- y – شماره ی سال در قالب دو عدد (برای مثال 17 به نشانه ی 2017).
- a – am یا pm با حروف کوچک.
- A – AM یا PM با حروف بزرگ.
- B - نشانگر Swatch Internet time (تقسیم روزهای خورشیدی به 1000 بخش. به جای ساعت و دقیقه روز های خورشیدی به 1000 بخش تقسیم می شوند و بازه ی 000 تا 999 را شامل می شود).
- g – مقدار ساعت با فرمت 12 ساعته (بازه ی 1 تا 12).
- G – مقدار ساعت با فرمت 24 ساعته (بازه ی 0 تا 23).
- h – مقدار ساعت با فرمت 12 ساعته (بازه ی 01 تا 12).
- H – بیانگر مقدار ساعت با فرمت 24 ساعته (00 تا 24).
- i – مقدار دقیقه را با صفرهای آغازین نمایش می دهد (بازه ی 00 تا 59).
- s – نشانگر مقدار ثانیه با صفرهای آغازین می باشد (بازه ی 00 تا 59).
- e – اسم منطقه ی زمانی (به عنوان مثال می توان به UTC، Atlantic/Azores اشاره کرد).
- I (حرف بزرگ i) – مشخص می کند آیا تاریخ بر اساس ساعت تابستانی نمایش داده شود یا خیر (چنانچه تاریخ بر اساس ساعت تابستانی نمایش داده شود، مقدار 1 و در غیر این صورت بر روی 0 تنظیم می شود).
- O – نشانگر اختلاف زمانی با GMT بر حسب ساعت می باشد (مثال: +0100).
- T – تنظیم منطقه ی زمانی دستگاهی که اسکپریت PHP بر روی آن مستقر می باشد (مثال: EST، MDT).
- Z – اختلاف منطقه ی زمانی بر حسب ثانیه. مقدار اختلاف زمانی غرب UTC، منفی و شرق آن مثبت می باشد (بازه ی -43200 و 43200).
- c – نمایش مقدار تاریخ بر اساس استاندارد ISO-8601 (مثال: 2004-02-12T15:19:21+00:00 ).
- r – تاریخ فرمت دهی شده بر اساس استاندارد RFC 2822 (مثال: Thu, 21 Dec 2000 16:01:07 +0200).
- U – ثانیه های سپری شده از زمان Unix (January 1 1970 00:00:00 GMT).
خروجی تابع ()date_format در PHP
این تابع در صورت موفقیت تاریخ فرمت شده و در غیر این صورت FALSE را برمی گرداند.
مثال:
format("Y-m-d\TH:i:s\Z");
echo "
";
# Using second function.
$dateTime = new DateTime($dateSrc);
$dateTime->setDate( 1999, 10, 12);
echo "New Formatted date is ". $dateTime->format("Y-m-d\TH:i:s\Z");
?>
خروجی:
New Formatted date is 2000-12-12T12:50:00Z New Formatted date is 1999-10-12T12:50:00Z