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 InformationsSi vous utilisez un décalage DST (à savoir, si vous spécifiez une valeur d'argument ignore_dst évaluée sur False), vous devez spécifier un lieu au lieu d'un décalage GMT dans l'argument place. Cela est dû au fait que l'ajustement de Heure d'été nécessite des informations latitudinales en plus des informations longitudinales fournies par un décalage GMT. Pour des informations, voir Utilisation de décalages GMT en combinaison avec DST.
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 |
Si cet argument est évalué sur True, DST (Heure d'été) est ignoré. Les valeurs d'argument valides évaluées sur True incluent -1 et True(). Si cet argument est évalué sur False, l'horodatage est ajusté à l'heure d'été. Les valeurs d'argument valides évaluées sur False incluent 0 et False(). Si la valeur de l'argument ignore_dst n'est pas valide, la fonction évalue l'expression comme si la valeur de ignore_dst était évaluée sur True. Si la valeur de l'argument ignore_dst n'est pas spécifiée, la fonction évalue l'expression comme si la valeur de ignore_dst était évaluée sur False. |
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.
| A-C | D-K | L-R | S-Z |
|---|---|---|---|
| Abu Dhabi | Darwin | La Paz | Samoa |
| Adelaide | Dhaka | Lima | Santiago |
| Alaska | Eastern Time (US & Canada) | Lisbon | Sapporo |
| Amsterdam | Edinburgh | Ljubljana | Sarajevo |
| Arizona | Ekaterinburg | London | Saskatchewan |
| Astana | Fiji | Madrid | Seoul |
| Athens | Georgetown | Magadan | Singapore |
| Atlantic Time (Canada) | Greenland | Mazatlan | Skopje |
| Auckland | Greenwich Mean Time : Dublin | Melbourne | Sofia |
| Azores | Guadalajara | Mexico City | Solomon Is. |
| Baghdad | Guam | Mid-Atlantic | Sri Jayawardenepura |
| Baku | Hanoi | Minsk | St. Petersburg |
| Bangkok | Harare | Monrovia | Stockholm |
| Beijing | Hawaii | Monterrey | Sydney |
| Belgrade | Helsinki | Moscow | Taipei |
| Berlin | Hobart | Mountain Time (US & Canada) | Tallinn |
| Bern | Hong Kong | Mumbai | Tashkent |
| Bogota | Indiana (East) | Muscat | Tbilisi |
| Brasilia | International Date Line West | Nairobi | Tehran |
| Bratislava | Irkutsk | New Caledonia | Tokyo |
| Brisbane | Islamabad | New Delhi | Urumqi |
| Brussels | Istanbul | Newfoundland | Warsaw |
| Bucharest | Jakarta | Novosibirsk | Wellington |
| Budapest | Jerusalem | Nuku'alofa | West Central Africa |
| Buenos Aires | Kabul | Osaka | Vienna |
| Cairo | Kamchatka | Pacific Time (US & Canada) | Vilnius |
| Canberra | Karachi | Paris | Vladivostok |
| Cape Verde Is. | Kathmandu | Perth | Volgograd |
| Caracas | Kolkata | Port Moresby | Yakutsk |
| Casablanca | Krasnoyarsk | Prague | Yerevan |
| Central America | Kuala Lumpur | Pretoria | Zagreb |
| Central Time (US & Canada) | Kuwait | Quito | - |
| Chennai | Kyiv | Riga | - |
| Chihuahua | - | Riyadh | - |
| Chongqing | - | Rome | - |
| Copenhagen | - | - | - |
| Exemple | Résultat |
|---|---|
|
ConvertToLocalTime('2023-08-14 08:39:47','Paris') |
Renvoie '2023-08-14 10:39:47' et la représentation d'horodatage interne correspondante. |
| ConvertToLocalTime(UTC(), 'Stockholm') | Renvoie l'heure pour Stockholm, en l'ajustant à l'heure d'été. |
| ConvertToLocalTime(UTC(), 'Stockholm', -1) | Renvoie l'heure pour Stockholm, sans l'ajuster à l'heure d'été. |
| ConvertToLocalTime(UTC(), 'GMT-05:00') | Renvoie l'heure de la côte est nord-américaine, par exemple New York. Aucun ajustement n'est apporté en fonction de l'heure d'été, car un décalage GMT est spécifié au lieu d'un lieu. |
| ConvertToLocalTime(UTC(), 'New York', -1) | Renvoie l'heure de la côte est nord-américaine (New York), sans l'ajuster à l'heure d'été. |
| ConvertToLocalTime(UTC(), 'New York', True()) | Renvoie l'heure de la côte est nord-américaine (New York), sans l'ajuster à l'heure d'été. |
| ConvertToLocalTime(UTC(), 'New York', 0) | Renvoie l'heure de la côte est nord-américaine (New York), en l'ajustant à l'heure d'été. |
| ConvertToLocalTime(UTC(), 'New York', False()) | Renvoie l'heure de la côte est nord-américaine (New York), en l'ajustant à l'heure d'été. |
Utilisation de décalages GMT en combinaison avec DST
Suite à la mise en œuvre des bibliothèques International Components for Unicode (ICU) dans QlikView November 2018, l'utilisation de décalages GMT (Greenwich Mean Time - Heure moyenne de Greenwich) en combinaison avec DST (Daylight Saving Time - Heure d'été) nécessite des informations latitudinales supplémentaires.
GMT est un décalage longitudinal (est-ouest), tandis que DST est un décalage latitudinal (nord-sud). Par exemple, Helsinki (Finlande) et Johannesburg (Afrique du Sud) partagent le même décalage GMT+02:00, mais ne partagent pas le même décalage DST. Cela signifie que, en plus du décalage GMT, tout décalage DST nécessite des informations sur la position latitudinale du fuseau horaire local (entrée de fuseau horaire géographique) pour disposer de l'ensemble des informations sur les conditions DST locales.
