תחביר
התחביר של ה date_offset_get() הפונקציה היא כדלקמן:
int תאריך_offset_get ( תאריך שעה $object )הפרמטר של הפונקציה הוא:
$object: האובייקט DateTime שממנו יש לאחזר את היסט אזור הזמן.
ערך החזרה
ה date_offset_get() הפונקציה מחזירה את היסט אזור הזמן בשניות כמספר שלם.
כיצד להשתמש בפונקציה date_offset_get() ב-PHP
הנה דוגמה לשימוש ב-PHP date_offset_get() פונקציה לאחזור היסט UTC עבור אזור הזמן הנוכחי:
$date = חָדָשׁ תאריך שעה ( 'עַכשָׁיו' ) ;
$ קיזוז = תאריך_offset_get ( $date ) ;
הֵד 'היסט:' . $ קיזוז ;
?>
בדוגמה זו, אנו יוצרים אובייקט DateTime חדש המוגדר לתאריך והשעה הנוכחיים באמצעות ה- 'עַכשָׁיו' חוּט. לאחר מכן אנו מעבירים את האובייקט הזה ל- date_offset_get() פונקציה, המחזירה את היסט UTC בשניות. לבסוף, אנו מדפיסים את היסט UTC באמצעות הצהרת הד.
הערה: ההיסט הוא אפס מכיוון שהזמן לא נקבע למקרה זה.
קבלת קיזוז עבור תאריך ושעה ספציפיים
ה-PHP date_offset_get() ניתן להשתמש בשיטה גם כדי לקבל את היסט UTC עבור תאריך ושעה מסוימים. לשם כך, עליך ליצור אובייקט DateTime עם התאריך והשעה הרצויים ולהעביר אותו לפונקציה. הנה דוגמא:
$date = חָדָשׁ תאריך שעה ( '2020-12-31 23:59:59' , חָדָשׁ DateTimeZone ( 'אמריקה/ניו_יורק' ) ) ;
$ קיזוז = תאריך_offset_get ( $date ) ;
הֵד 'היסט:' . $ קיזוז ;
?>
בדוגמה זו, אנו יוצרים אובייקט DateTime חדש עם התאריך והשעה מוגדרים ל-31 בדצמבר 2020, בשעה 23:59:59 באזור הזמן America/New_York. לאחר מכן אנו מעבירים את האובייקט הזה ל- date_offset_get() פונקציה, המחזירה את היסט UTC בשניות. לבסוף, אנו מדפיסים את היסט UTC באמצעות הצהרת הד.
הערה: בקוד לעיל, אזור הזמן מוגדר ל אמריקה/ניו_יורק שנמצא 5 שעות אחרי UTC. לפיכך, זה חוזר -18000 כקיזוז שהוא 5 שעות בשניות.
המרת התאריך והשעה לאזור זמן אחר
דרך נוספת להשתמש ב-PHP date_offset_get() הפונקציה היא להמיר אובייקט תאריך ושעה לאזור זמן אחר. כדי לעשות זאת, עליך ליצור חדש DateTimeZone אובייקט עם אזור הזמן הרצוי והגדר אותו כמאפיין של אובייקט DateTime שלך באמצעות קבע תאריך() ו זמן מוגדר() שיטות. הנה דוגמא:
$date = חָדָשׁ תאריך שעה ( 'עַכשָׁיו' , חָדָשׁ DateTimeZone ( 'אמריקה/ניו_יורק' ) ) ;
$date -> setTimeZone ( חָדָשׁ DateTimeZone ( 'אירופה/לונדון' ) ) ;
$ קיזוז = תאריך_offset_get ( $date ) ;
הֵד 'היסט:' . $ קיזוז ;
?>
בדוגמה זו, התאריך והשעה הנוכחיים נוצרים כאובייקט DateTime חדש באזור הזמן America/New_York. לאחר מכן, הגדרנו את אזור הזמן לאירופה/לונדון באמצעות ה setTimeZone() שיטה. לבסוף, אנו מדפיסים את התאריך והשעה באמצעות ה פוּרמָט() שיטה, המעצבת את התאריך והשעה למחרוזת המבוססת על הפורמט שצוין.
הערה: בקוד לעיל, אזור הזמן מוגדר ל אמריקה/ניו_יורק שנמצא 5 שעות אחרי UTC. לאחר מכן הגדרנו את אזור הזמן ל אירופה/לונדון שנמצא בשעה אחת לפני UTC. לפיכך, הוא מחזיר 3600 כהיסט שהוא שעה אחת בשניות.
סיכום
PHP date_offset_get() function היא פונקציה שימושית עבור מפתחי אינטרנט כדי לחלץ את ההיסט של אזור הזמן של תאריך ושעה מוגדרים. בשילוב עם פונקציות תאריך ושעה אחרות, ניתן להשתמש בו כדי לחשב את הפרש הזמן בין שני אזורי זמן או להתאים את חותמת הזמן בהתאם. הבנה כיצד להשתמש בפונקציה זו ביעילות יכולה לשפר משמעותית את הפונקציונליות והיכולות של כל יישום מבוסס אינטרנט.