PHP date_interval_format() Function












❮ مرجع تاریخ/زمان PHP



مثال


فاصله بین دو تاریخ را محاسبه کنید، سپس فاصله را قالب بندی کنید:




$date1=date_create("2013-01-01");
$date2=date_create("2013-02-10");

$diff=date_diff($date1,$date2);

// %a تعداد کل روزها را خروجی می‌دهد
echo $diff->format("تعداد کل روزها: %a.") ;
؟>

این را خودتان امتحان کنید »



تعریف و استفاده


تابع date_interval_format() نام مستعار DateInterval::format().


از تابع DateInterval::format() برای قالب بندی فاصله استفاده می شود.




نحو



DateInterval::format(format)

مقادیر پارامتر











پارامتر توضیح
قالب لازم است. فرمت را مشخص می کند. کاراکترهای زیر را می توان در رشته پارامتر format استفاده کرد:

  • % - % تحت اللفظی

  • Y - سال، حداقل 2 رقم با صفر اول (مثلاً 03)

  • y - سال (مثلاً 3)

  • M - ماه، با صفر اول (مثلاً 06)

  • m - ماه (به عنوان مثال 6)

  • D - روز، با صفر اول (مثلاً 09)

  • d - روز (مثلاً 9)

  • a - تعداد کل روزها در نتیجه date_diff()

  • H - ساعت، با صفر اول (مثلاً 08، 23)

  • ساعت - ساعت (مثلاً 8، 23)

  • I - دقیقه، با صفر اول (مثلاً 08، 23)

  • i - دقیقه (مثلاً 8، 23)

  • S - ثانیه، با صفر اول (مثلاً 08، 23)

  • s - ثانیه (مثلاً 8، 23)

  • F - میکروثانیه، حداقل 6 رقم (به عنوان مثال 004403، 235689)

  • f - میکروثانیه (مثلاً 4403، 235689)

  • R - علامت "-" وقتی منفی است، "+" وقتی مثبت است

  • r - علامت "-" وقتی منفی، خالی وقتی مثبت است


توجه: هر کاراکتر قالب باید با علامت % پیشوند باشد!










جزئیات فنی















مقدار بازگشتی: فاصله قالب‌بندی شده را برمی‌گرداند
نسخه PHP: 5.3+
تغییر PHP: PHP 7.1: پارامترهای F و f را اضافه کرد



❮ مرجع تاریخ/زمان PHP