TimeZoneOffset

Syntaxe

Paramètres

Description

Cette fonction permet de retourner le décalage de fuseau horaire de l'utilisateur actuel.

Remarques

• La fonction TimeZoneOffset est essentielle pour gérer les différences de fuseau horaire : Elle permet de connaître précisément l'écart entre l'heure locale de l'utilisateur et l'heure UTC. Cela est particulièrement utile pour afficher des informations temporelles cohérentes dans des applications utilisées à l'échelle internationale.
• Elle peut fonctionner avec ou sans paramètre, offrant de la flexibilité : Si aucun paramètre n'est fourni, la fonction utilise automatiquement l'heure actuelle de l'appareil de l'utilisateur. Sinon, elle accepte une date spécifique pour laquelle on veut connaître le décalage, ce qui permet d'anticiper ou de corriger des calculs temporels.
• Le résultat est une durée exprimée en minutes : Le décalage renvoyé est de type Number, indiquant le nombre de minutes entre l'heure locale et l'UTC. Par exemple, un résultat de -240 signifie que l'heure locale est UTC-4.
• Elle prend en compte les ajustements dus à l'heure d'été ou d'hiver : Lorsque le paramètre DateTime est renseigné, TimeZoneOffset calcule le décalage en prenant en considération les éventuels changements d'heure saisonniers, ce qui améliore la précision des résultats.
• C'est une fonction précieuse pour la normalisation des données temporelles : Lorsqu'on entrepose des dates dans une base de données partagée entre utilisateurs de plusieurs fuseaux horaires, TimeZoneOffset permet de corriger les écarts pour assurer une interprétation cohérente.
• Elle peut être combinée avec des fonctions comme DateAdd ou DateTimeValue : En utilisant le décalage fourni, on peut ajuster les dates et heures pour les afficher dans une zone horaire cible ou pour les convertir en UTC lors d'entreposage.
• Le comportement par défaut dépend de l'environnement d'exécution : Puisque l'heure locale est déterminée par le système de l'utilisateur, les résultats peuvent varier si l'application est utilisée sur un mobile, un navigateur ou un poste configuré dans un autre fuseau.
• Elle est idéale pour des scénarios impliquant des utilisateurs dispersés géographiquement : Dans les solutions d'entreprise ou les portails publics, il est souvent nécessaire d'adapter l'affichage des heures selon la localisation. TimeZoneOffset devient alors un outil incontournable pour personnaliser les données temporelles à l'utilisateur.