استخدام دالة PHP date_create_immutable() و مثال

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

تستعيد دالة date_create_immutable() كائن DateTimeImmutable جديد

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

date_create_immutable() هو اسم اختصار لـ DateTimeImmutable::__construct(). تأخذ هذه الدالة سلسلة التاريخ/الوقت ومساحة الوقت كمعلمات (اختياري) وتقوم بإنشاء كائن DateTimeImmutable.
مختلف عن كائن DateTime، لا يسمح هذا الكائن بأي تعديل، إن كان هناك تغيير يتم إنشاء كائن جديد ويعاد إرجاعه. بشكل افتراضي، يقوم هذا الدالة بإنشاء كائن للوقت الحالي/التاريخ.

النص الاصطناعي

date_create_immutable([$date_time,　$timezone]);

الإعداد

النتيجة

يستعيد دالة PHP date_create_immutable() كائن DateTimeImmutable المكون.

إصدار PHP

تم إدخال هذه الدالة في إصدار PHP 5.5.0، وهي قابلة للاستخدام في جميع الإصدارات الأحدث.

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

هذا المثال يعرضdate_create_immutable()استخدام الدالة-

<?php
　　　$date_string　=　"2019-08-15　9:25:45";
　　　$immutable　=　date_create_immutable($date_string);　　　
　　　print_r($immutable);
?>

نتيجة الإخراج

DateTimeImmutable Object
(
　　　　[date] => 2019-08-15 09:25:45.000000
　　　　[timezone_type] => 3
　　　　[timezone]　=>　UTC
)

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

هذا هو مثال يحتوي على معرفات الوقت-date_create_immutable()النموذج-

<?php
　　　$date_string　=　"2019-08-15　9:25:45";
　　　$tz = new DateTimeZone('Indian/Mahe');
　　　$immutable = date_create_immutable($date_string, $tz);　　　
　　　print_r($immutable);　　　
　　　print(date_format($immutable, 'Y-m-d H:i:s'));　
?>

نتيجة الإخراج

DateTimeImmutable Object
(
　　　　[date] => 2019-08-15 09:25:45.000000
　　　　[timezone_type] => 3
　　　　[timezone] => Indian/Mahe
)
2019-08-15 09:25:45

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

في المثال التالي، قمنا بإنشاء تاريخ غير قابل للتغيير، وأضفنا فاصل إلى عنوان التاريخ العادي، وعرضنا القيم الناتجة. نظرًا لأن عنوان DateTimeImmutable سيقوم بإنشاء وتقديم عنصر جديد عند التغيير، لذلك يمكنك ملاحظة أن هناك تغييرًا قبل وبعد التغيير-

<?php
　　　print("التاريخ غير القابل للتغيير: "."\n");
　　　$date1 = date_create_immutable('1986-09-11');
　　　$date2 = $date1->add(new DateInterval('P15DP12MP9YT24H'));
　　　print("قيمة العنصر الأصلي: ".$date1->format('Y-m-d')."\n");
　　　print("بعد التغيير: ".$date2->format('Y-m-d')."\n");
　　　print("التاريخ العادي: "."\n");
　　　$date3 = date_create('1986-09-11');
　　　$date4 = $date3->add(new DateInterval('P15DP12MP9YT24H'));
　　　print("قيمة العنصر الأصلي: ".$date3->format('Y-m-d')."\n");
　　　print("بعد التغيير: ".$date4->format('Y-m-d')."\n");
?>

نتيجة الإخراج

التاريخ غير القابل للتغيير:　
قيمة العنصر الأصلي: 1986-09-11
بعد التغيير: 1996-09-27
التاريخ العادي:　
قيمة العنصر الأصلي: 1996-09-27
بعد التغيير: 1996-09-27