بناء الجملة
بناء جملة date_offset_get () الوظيفة على النحو التالي:
int date_offset_get ( التاريخ والوقت الكائن $ )معلمة الوظيفة هي:
الكائن $: كائن DateTime المراد استرداد إزاحة المنطقة الزمنية منه.
قيمة الإرجاع
ال date_offset_get () تقوم الدالة بإرجاع إزاحة المنطقة الزمنية بالثواني كعدد صحيح.
كيفية استخدام دالة date_offset_get () في PHP
فيما يلي مثال على كيفية استخدام PHP date_offset_get () لاسترداد تعويض UTC للمنطقة الزمنية الحالية:
<؟ php
التاريخ $ = جديد التاريخ والوقت ( 'الآن' ) ؛
تعويض $ = date_offset_get ( التاريخ $ ) ؛
صدى صوت 'عوض: ' . تعويض $ ؛
؟>
في هذا المثال ، نقوم بإنشاء كائن DateTime جديد مضبوط على التاريخ والوقت الحاليين باستخدام ملف 'الآن' خيط. ثم نقوم بتمرير هذا الكائن إلى date_offset_get () دالة ، والتي تُرجع تعويض التوقيت العالمي المتفق عليه (UTC) في ثوانٍ. أخيرًا ، نقوم بطباعة تعويض UTC باستخدام بيان echo.
ملحوظة: الإزاحة هي صفر لأنه لم يتم تعيين الوقت لهذه الحالة.
الحصول على الإزاحة لتاريخ ووقت محددين
لغة PHP date_offset_get () يمكن أيضًا استخدام الطريقة للحصول على تعويض التوقيت العالمي المنسق (UTC) لتاريخ ووقت معينين. للقيام بذلك ، تحتاج إلى إنشاء كائن DateTime بالتاريخ والوقت المطلوبين وتمريره إلى الوظيفة. هنا مثال:
<؟ phpالتاريخ $ = جديد التاريخ والوقت ( '2020-12-31 23:59:59' و جديد DateTimeZone ( 'أمريكا / نيويورك' ) ) ؛
تعويض $ = date_offset_get ( التاريخ $ ) ؛
صدى صوت 'عوض: ' . تعويض $ ؛
؟>
في هذا المثال ، نقوم بإنشاء كائن DateTime جديد مع تعيين التاريخ والوقت على 31 ديسمبر 2020 ، الساعة 11:59:59 مساءً في المنطقة الزمنية America / New_York. ثم نقوم بتمرير هذا الكائن إلى date_offset_get () دالة ، والتي تُرجع تعويض التوقيت العالمي المتفق عليه (UTC) في ثوانٍ. أخيرًا ، نقوم بطباعة تعويض UTC باستخدام بيان echo.
ملحوظة: في الكود أعلاه ، تم تعيين المنطقة الزمنية على أمريكا / نيويورك وهو متأخر 5 ساعات عن التوقيت العالمي المنسق. ومن ثم يعود -18000 كإزاحة وهي 5 ساعات بالثواني.
تحويل التاريخ والوقت إلى منطقة زمنية مختلفة
طريقة أخرى لاستخدام PHP date_offset_get () الوظيفة هي تحويل كائن التاريخ والوقت إلى منطقة زمنية مختلفة. للقيام بذلك ، تحتاج إلى إنشاء ملف DateTimeZone مع المنطقة الزمنية المطلوبة وتعيينها كخاصية لكائن DateTime باستخدام امتداد setDate () و ضبط الوقت() طُرق. هنا مثال:
<؟ phpالتاريخ $ = جديد التاريخ والوقت ( 'الآن' و جديد DateTimeZone ( 'أمريكا / نيويورك' ) ) ؛
التاريخ $ -> setTimeZone ( جديد DateTimeZone ( 'أوروبا / لندن' ) ) ؛
تعويض $ = date_offset_get ( التاريخ $ ) ؛
صدى صوت 'عوض: ' . تعويض $ ؛
؟>
في هذا المثال ، يتم إنشاء التاريخ والوقت الحاليين ككائن DateTime جديد في المنطقة الزمنية America / New_York. ثم قمنا بتعيين المنطقة الزمنية على أوروبا / لندن باستخدام setTimeZone () طريقة. أخيرًا ، نقوم بطباعة التاريخ والوقت باستخدام ملف شكل() الطريقة ، التي تعمل على تنسيق التاريخ والوقت في سلسلة بناءً على التنسيق المحدد.
ملحوظة: في الكود أعلاه ، تم تعيين المنطقة الزمنية على أمريكا / نيويورك وهو متأخر 5 ساعات عن التوقيت العالمي المنسق. ثم قمنا بتعيين المنطقة الزمنية على أوروبا / لندن وهو قبل ساعة واحدة من التوقيت العالمي المنسق (UTC). ومن ثم ، فإنها تُرجع 3600 كإزاحة وهي ساعة واحدة بالثواني.
خاتمة
بي أتش بي date_offset_get () وظيفة مفيدة لمطوري الويب لاستخراج إزاحة المنطقة الزمنية لتاريخ ووقت محددين. بالاشتراك مع وظائف التاريخ والوقت الأخرى ، يمكن استخدامه لحساب فرق الوقت بين منطقتين زمنيتين أو ضبط الطابع الزمني وفقًا لذلك. يمكن أن يؤدي فهم كيفية استخدام هذه الوظيفة بشكل فعال إلى تحسين وظائف وقدرات أي تطبيق قائم على الويب بشكل كبير.