Süntaks
Süntaks date_offset_get() funktsioon on järgmine:
int date_offset_get ( Kuupäev Kellaaeg $objekt )Funktsiooni parameeter on:
$objekt: DateTime objekt, millest ajavööndi nihe tuua.
Tagastusväärtus
The date_offset_get() funktsioon tagastab ajavööndi nihke sekundites täisarvuna.
Funktsiooni date_offset_get() kasutamine PHP-s
Siin on näide PHP kasutamisest date_offset_get() funktsioon praeguse ajavööndi UTC nihke hankimiseks:
$kuupäev = uus Kuupäev Kellaaeg ( 'nüüd' ) ;
$nihe = date_offset_get ( $kuupäev ) ;
kaja 'Nihe: ' . $nihe ;
?>
Selles näites loome uue DateTime objekti, mis on seatud praegusele kuupäevale ja kellaajale, kasutades 'nüüd' string. Seejärel anname selle objekti edasi date_offset_get() funktsioon, mis tagastab UTC nihke sekundites. Lõpuks trükime kajalause abil UTC nihke.
Märge: Nihe on null, kuna selle juhtumi jaoks pole aega määratud.
Tasaarvestus kindla kuupäeva ja kellaaja eest
PHP date_offset_get() meetodit võib kasutada ka teatud kuupäeva ja kellaaja UTC nihke saamiseks. Selleks tuleb luua soovitud kuupäeva ja kellaajaga DateTime objekt ning edastada see funktsioonile. Siin on näide:
$kuupäev = uus Kuupäev Kellaaeg ( '2020-12-31 23:59:59' , uus DateTimeZone ( 'Ameerika/New_York' ) ) ;
$nihe = date_offset_get ( $kuupäev ) ;
kaja 'Nihe: ' . $nihe ;
?>
Selles näites loome uue DateTime objekti, mille kuupäev ja kellaaeg on seatud Ameerika/New_Yorki ajavööndis 31. detsember 2020 kell 23:59:59. Seejärel anname selle objekti edasi date_offset_get() funktsioon, mis tagastab UTC nihke sekundites. Lõpuks trükime kajalause abil UTC nihke.
Märge: Ülaltoodud koodis on ajavööndiks seatud Ameerika/New_York mis on UTC-st 5 tundi maas. Järelikult naaseb -18 000 nihkena, mis on 5 tundi sekundites.
Kuupäeva ja kellaaja teisendamine teisele ajavööndile
Teine viis PHP kasutamiseks date_offset_get() funktsioon on teisendada kuupäeva ja kellaaja objekt teise ajavööndisse. Selleks peate looma uue DateTimeZone objekti soovitud ajavööndiga ja määrake see oma DateTime objekti atribuudiks kasutades setDate() ja määra aeg() meetodid. Siin on näide:
$kuupäev = uus Kuupäev Kellaaeg ( 'nüüd' , uus DateTimeZone ( 'Ameerika/New_York' ) ) ;
$kuupäev -> seaTimeZone ( uus DateTimeZone ( 'Euroopa/London' ) ) ;
$nihe = date_offset_get ( $kuupäev ) ;
kaja 'Nihe: ' . $nihe ;
?>
Selles näites luuakse praegune kuupäev ja kellaaeg uue DateTime objektina Ameerika/New_Yorki ajavööndis. Seejärel määrasime ajavööndiks Euroopa/London, kasutades setTimeZone() meetod. Lõpuks prindime kuupäeva ja kellaaja, kasutades nuppu formaat () meetod, mis vormindab kuupäeva ja kellaaja määratud vormingu alusel stringiks.
Märge: Ülaltoodud koodis on ajavööndiks seatud Ameerika/New_York mis on UTC-st 5 tundi maas. Seejärel määrasime ajavööndiks Euroopa/London mis on UTC-st 1 tund ees. Seega tagastab see nihkena 3600, mis on sekundites 1 tund.
Järeldus
PHP date_offset_get() funktsioon on veebiarendajatele kasulik funktsioon ajavööndi nihke eraldamiseks määratud kuupäevast ja kellaajast. Koos muude kuupäeva ja kellaaja funktsioonidega saab seda kasutada kahe ajavööndi vahelise ajavahe arvutamiseks või ajatempli vastavalt kohandamiseks. Selle funktsiooni tõhusa kasutamise mõistmine võib oluliselt parandada mis tahes veebipõhise rakenduse funktsionaalsust ja võimalusi.