Syntaxe
La syntaxe de la date_offset_get() fonction est la suivante :
entier date_offset_get ( DateHeure $objet )Le paramètre de la fonction est :
$objet : Objet DateTime à partir duquel récupérer le décalage de fuseau horaire.
Valeur de retour
Le date_offset_get() renvoie le décalage horaire en secondes sous la forme d'un entier.
Comment utiliser la fonction date_offset_get() en PHP
Voici un exemple d'utilisation du PHP date_offset_get() fonction pour récupérer le décalage UTC pour le fuseau horaire actuel :
$date = nouveau DateHeure ( 'maintenant' ) ;
$ décalage = date_offset_get ( $date ) ;
écho 'Compenser: ' . $ décalage ;
?>
Dans cet exemple, nous créons un nouvel objet DateTime défini sur la date et l'heure actuelles à l'aide de la propriété 'maintenant' chaîne. On passe ensuite cet objet au date_offset_get() fonction, qui renvoie le décalage UTC en secondes. Enfin, nous imprimons le décalage UTC à l'aide de l'instruction echo.
Note: Le décalage est nul car l'heure n'est pas définie pour ce cas.
Obtenir un décalage pour une date et une heure spécifiques
Le PHP date_offset_get() peut également être utilisée pour obtenir le décalage UTC pour une certaine date et heure. Pour ce faire, vous devez créer un objet DateTime avec la date et l'heure souhaitées et le transmettre à la fonction. Voici un exemple:
$date = nouveau DateHeure ( '2020-12-31 23:59:59' , nouveau DateTimeZone ( 'Amérique/New_York' ) ) ;
$ décalage = date_offset_get ( $date ) ;
écho 'Compenser: ' . $ décalage ;
?>
Dans cet exemple, nous créons un nouvel objet DateTime avec la date et l'heure définies sur le 31 décembre 2020 à 23 h 59 min 59 s dans le fuseau horaire America/New_York. On passe ensuite cet objet au date_offset_get() fonction, qui renvoie le décalage UTC en secondes. Enfin, nous imprimons le décalage UTC à l'aide de l'instruction echo.
Note: Dans le code ci-dessus, le fuseau horaire est défini sur Amérique/New_York qui a 5 heures de retard sur UTC. Par conséquent, il revient -18000 comme le décalage qui est de 5 heures en secondes.
Conversion de la date et de l'heure dans un autre fuseau horaire
Une autre façon d'utiliser le PHP date_offset_get() fonction consiste à convertir un objet date et heure dans un fuseau horaire différent. Pour ce faire, vous devez créer un nouveau DateTimeZone objet avec le fuseau horaire souhaité et définissez-le comme la propriété de votre objet DateTime à l'aide de la régler la date() et régler le temps() méthodes. Voici un exemple:
$date = nouveau DateHeure ( 'maintenant' , nouveau DateTimeZone ( 'Amérique/New_York' ) ) ;
$date -> setTimeZone ( nouveau DateTimeZone ( 'Europe/Londres' ) ) ;
$ décalage = date_offset_get ( $date ) ;
écho 'Compenser: ' . $ décalage ;
?>
Dans cet exemple, la date et l'heure actuelles sont créées en tant que nouvel objet DateTime dans le fuseau horaire America/New_York. Nous avons ensuite défini le fuseau horaire sur Europe/Londres à l'aide du setTimeZone() méthode. Enfin, nous imprimons la date et l'heure à l'aide de la format() méthode, qui formate la date et l'heure dans une chaîne basée sur le format spécifié.
Note: Dans le code ci-dessus, le fuseau horaire est défini sur Amérique/New_York qui a 5 heures de retard sur UTC. Nous définissons ensuite le fuseau horaire sur Europe/Londres qui a 1 heure d'avance sur UTC. Par conséquent, il renvoie 3600 comme décalage qui est de 1 heure en secondes.
Conclusion
PHP date_offset_get() La fonction est une fonction utile pour les développeurs Web pour extraire le décalage du fuseau horaire d'une date et d'une heure spécifiées. En combinaison avec d'autres fonctions de date et d'heure, il peut être utilisé pour calculer le décalage horaire entre deux fuseaux horaires ou ajuster l'horodatage en conséquence. Comprendre comment utiliser efficacement cette fonction peut considérablement améliorer les fonctionnalités et les capacités de toute application Web.