Convertit un horodatage UTC ou GMT en heure locale sous la forme d'une valeur double.
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Type de données renvoyé : double
| Argument | Description |
|---|---|
| timestamp | Date à évaluer en tant qu'horodatage ou expression aboutissant à un horodatage, à convertir, par exemple '2012-10-12'. |
| place |
Lieu ou fuseau horaire issu de la table de lieux ou fuseaux horaires valides ci-dessous. Une autre solution pour définir l'heure locale consiste à utiliser GMT ou UTC. Les valeurs et plages de décalage horaire suivantes sont valides :
Note InformationsVous pouvez uniquement appliquer des décalages horaires standard. Il est impossible d'utiliser un décalage horaire arbitraire, tel que GMT-04:27.
|
| ignore_dst | Définissez la valeur sur True pour ignorer l'heure d'été DST (Daylight Saving Time). |
L'heure résultante est ajustée en fonction de l'heure d'été, sauf si le paramètre ignore_dst est défini sur True.
Lieux et fuseaux horaires valides
La fonction ConvertToLocalTime récupère les informations sur les lieux et les fuseaux horaires du monde entier à partir du registre Windows. Autrement dit, pour pouvoir utiliser cette fonction, assurez-vous que le nom du lieu souhaité corresponde exactement au nom figurant dans le registre Windows.
Le nom exact sous lequel un lieu est enregistré dans le registre Windows peut également varier en fonction des paramètres de langue de votre installation Windows. Cette différence s'explique par le fait que les noms de certaines villes et de certains pays ne sont pas orthographiés de la même façon dans toutes les langues.
La liste complète des lieux et fuseaux horaires figurant dans le registre Windows se trouve à l'emplacement suivant :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
Vous pouvez également accéder à la liste des fuseaux horaires et des lieux via le Panneau de configuration de Windows. Ouvrez le Panneau de configuration, cliquez sur les paramètres Date et heure, puis sur Changer de fuseau horaire. La liste complète des villes ou pays associés à chaque fuseau horaire est disponible dans le menu déroulant.
| Exemple | Résultat |
|---|---|
| ConvertToLocalTime('2007-11-10 23:59:00','Paris') | Renvoie '2007-11-11 00:59:00' et la représentation d'horodatage interne correspondante. |
| ConvertToLocalTime(UTC(), 'GMT-05:00') | Renvoie l'heure de la côte est nord-américaine, par exemple New York. |
| ConvertToLocalTime(UTC(), 'GMT-05:00', True) | Renvoie l'heure de la côte est nord-américaine, par exemple New York, sans l'ajustement en fonction de l'heure d'été. |
Utilisation de décalages GMT en combinaison avec DST
Suite à la mise œuvre des bibliothèques International Components for Unicode (ICU) dans QlikView November 2018, l'utilisation de décalages GMT (Greenwich Mean Time) en combinaison avec DST (Daylight Saving Time) nécessite des informations de latitude supplémentaires.
GMT est un décalage de longitude (est-ouest), tandis que DST est un décalage de latitude (nord-sud). Par exemple, Helsinki (Finlande) et Johannesburg (Afrique du Sud) partagent le même décalage GMT+02h00, mais pas le même décalage DST. Cela signifie qu'en plus du décalage GMT, tout décalage DST nécessite des informations sur la position de latitude du fuseau horaire local (saisie du fuseau horaire géographique) afin d'avoir des informations complètes sur les conditions DST locales.
