English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

دليل تعليمات PHP الأساسية

دليل تعليمات PHP المتقدمة

PHP & MySQL

دليل مرجع PHP

استخدام وظيفة PHP date_interval_format() وآمثلة

دليل وظائف PHP Date & Time

تستخدم دالة date_interval_format() لصياغة الفواصل الزمنية.

التعريف والاستخدام

date_interval_format()الدالة هي اسم别名 لـ DateInterval::format. تأخذ الدالة فاصلًا وتماماً نص صيغة كمعلمات، وتصيغ الفاصل المحدد بالصيغة المحددة.

النص اللفظي

date_interval_format($interval, $format)

المواصفة

رقمالمواصفات والشرح
1

interval (مطلوب)

هذا هو الكائن DateInterval الذي تريد صيغته.

2

format (مطلوب)

هذه قيمة نصية تُحدد الصيغة.

القيمة الم返回ة

تقوم هذه الدالة بإرجاع فاصل صيغته

إصدار PHP

تم إدخال هذه الدالة لأول مرة في إصدار PHP 5.3، ويمكن استخدامها في جميع الإصدارات الأعلى.

مثال على الإنترنت

الآمثلة التالية توضح date_interval_format()استخدام الدالة -

<?php
  $interval = new DateInterval('P25DP8MP9Y');
  $format = "%d يوم";
  $res = date_interval_format($interval, $format);
  print($res);  
؟
اختبار لرؤية‹/›

نتيجة الخروج

25 يومًا

مثال على الإنترنت

مختلفة عن وظائف التواريخ والأوقات الأخرى،date_interval_format()لن يتم إعادة حساب نقاط التحويل في نسيج سلاسل التواريخ والأوقات. لذلك، إذا كانت القيم الدينية/الوقتية التي ترسلها تتجاوز نطاقها، ستتم صياغتها كما يلي:

<?php
   $interval = new DateInterval('P45M');
   $format = "%m شهر";
   $res1 = date_interval_format($interval, $format);
   print($res1); 
  
   $res2 = date_interval_format(new DateInterval('PT30H'), "%h ساعة");
   print("\n".$res2);
؟
اختبار لرؤية‹/›

نتيجة الخروج

45 شهر
30 ساعة

مثال على الإنترنت

في هذا المثال يُحسب الفارق بين تاريخين مُعطيين وتُستخدمdate_interval_formatنتيجة تنسيق الدالة-

<?php
   $date1 = date_create("1989-09-25");
   $date2 = date_create("2012-09-09");
   $interval = date_diff($date1, $date2);
   $res = date_interval_format($interval, '%Y سنة %d يوم');
   print($res);  
؟
اختبار لرؤية‹/›

نتيجة الخروج:

22 سنة 15 يوم

مثال على الإنترنت

<?php
print(date_interval_format(new DateInterval('P12D'), "%d أيام")."\n");
print(date_interval_format(new DateInterval('P7M'), "%m أشهر")."\n");
print(date_interval_format(new DateInterval('P12Y'), "%y سنوات")."\n");
print(date_interval_format(new DateInterval('PT9H'), "%h ساعات")."\n");
print(date_interval_format(new DateInterval('PT45S'), "%s ثانية")."\n");
؟
اختبار لرؤية‹/›

نتيجة الخروج

22 سنوات 7 أيام
12 أيام
7 أشهر
12 سنوات
9 ساعات
45 ثانية