بناء الجملة لوظيفة date_time_set ()
بناء جملة date_time_set () الوظيفة في PHP معطاة أدناه.
التاريخ والوقت date_time_set ( التاريخ والوقت الكائن $ و int ساعة $ و int دقيقة $ و int ثانية دولار = 0 و int ميكروثانية دولار = 0 )معلمات الوظيفة هي:
- الكائن $: كائن DateTime المراد تعديله.
- ساعة $ : القيمة الجديدة لمكون الساعة.
- دقيقة $: القيمة الجديدة لمكون الدقيقة.
- الثانية بالدولار: (اختياري) القيمة الجديدة للمكون الثاني. الافتراضي هو 0.
- ميكروثانية دولار: (اختياري) القيمة الجديدة لمكوِّن الميكرو ثانية. الافتراضي هو 0.
يجب أن تكون هذه القيم بتنسيق سلسلة ، مع تنسيق الوقت بتنسيق 24 ساعة.
قيمة الإرجاع
يتم إرجاع كائن DateTime جديد بمكونات الوقت المحدّثة بواسطة ملف date_time_set () طريقة. لم يتم تغيير كائن DateTime الأساسي.
ملحوظة: من الجدير بالذكر أن ملف date_time_set () لا تقوم الدالة بتعديل كائن DateTime الأصلي ، وبدلاً من ذلك ، تقوم بإرجاع كائن DateTime جديد بالتاريخ والوقت المحددين. هذا يعني أنك إذا كنت ترغب في تحديث كائن DateTime بقيمة وقت جديدة ، فأنت بحاجة إلى تعيين القيمة المرجعة لـ date_time_set () تعمل مرة أخرى إلى كائن DateTime الأصلي.
على سبيل المثال:
<؟ phpالتاريخ $ = جديد التاريخ والوقت ( '2023-12-01 00:00:00' ) ؛
date_time_set ( التاريخ $ و 12 و 30 ) ؛
مطبعة ( 'تاريخ: ' . صيغة التاريخ ( التاريخ $ و 'Y / m / d H: i: s' ) ) ؛
؟>
في هذا المثال ، يقوم السطر الأول بإنشاء كائن DateTime جديد بتاريخ 1 ديسمبر 2023 عند منتصف الليل. السطر الثاني يستخدم date_time_set () لتعيين وقت الكائن على 12:30 مساءً وإعادة تعيين كائن DateTime الناتج إلى التاريخ $ عامل.
إذا قمت بتمرير قيم اليوم والشهر التي تقع خارج النطاق المسموح به أثناء استدعاء هذه الطريقة ، فستتم إضافتها إلى قيمها الأصلية.
<؟ phpالتاريخ $ = جديد التاريخ والوقت ( ) ؛
date_time_set ( التاريخ $ و 24 و 22 و 36 ) ؛
مطبعة ( 'تاريخ: ' . صيغة التاريخ ( التاريخ $ و 'Y / m / d H: i: s' ) ) ؛
؟>
يتم إنشاء كائن DateTime جديد يعكس التاريخ والوقت الحاليين بواسطة الكود أعلاه. يتم بعد ذلك ضبط وقت عنصر التاريخ والوقت على 24 ساعة و 22 دقيقة و 36 ثانية باستخدام ملف date_time_set () طريقة. ال صيغة التاريخ() ثم يتم استخدام الطريقة لتنسيق وطباعة التاريخ والوقت اللذين تم تغييرهما.
خاتمة
ال date_time_set () توفر الوظيفة في PHP طريقة مناسبة لتعيين أو تعديل مكونات الوقت لكائن DateTime. باستخدام هذه الوظيفة ، يمكن للمطورين بسهولة تغيير مكونات الساعة والدقيقة والثانية والميكرو ثانية لكائن DateTime. ال date_time_set () توفر الوظيفة المرونة والدقة في التعامل مع تعديلات الوقت ، مما يجعلها أداة قيمة للعمل مع التواريخ والأوقات في تطبيقات PHP.