converttolocaltime - Skript- und Diagrammfunktion
Konvertiert einen UTC- oder GMT-Zeitstempel in eine lokale Zeit als dualen Wert.
Syntax:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Rückgabedatentyp: dual
Argument | Beschreibung |
---|---|
timestamp | Für die Umwandlung des als Zeitstempel auszuwertenden Datums oder des Ausdrucks für die Auflösung eines Zeitstempels, z. B. '2012-10-12'. |
place |
Ein Ort oder eine Zeitzone aus der nachfolgenden Tabelle der Orte und Zeitzonen. Alternativ können Sie GMT oder UTC zur Definition einer Ortszeit verwenden. Die folgenden Werte und Zeitdifferenzen sind gültig:
InformationshinweisWenn Sie eine Sommerzeitdifferenz verwenden (d.h., wenn Sie einen ignore_dst-Argumentwert angeben, der False zurückgibt), müssen Sie einen Ort anstelle einer GMT-Differenz im Argument place angeben. Das liegt daran, dass zum Anpassen der Sommerzeit Angaben zum Breitengrad zusätzlich zu den Angaben zum Längengrad erforderlich sind, die in einer GMT-Differenz bereitgestellt werden. Weitere Informationen finden Sie unter Verwenden von GMT-Differenzen in Kombination mit Sommerzeit.
InformationshinweisSie können nur die Standardzeitdifferenzen verwenden. Es ist nicht möglich, beliebige Zeitdifferenzen anzugeben, zum Beispiel GMT-04:27.
|
ignore_dst |
Wenn dieses Argument True zurückgibt, wird DST (Sommerzeit) ignoriert. Zu den gültigen Argumentwerten, die True zurückgeben, zählen -1 und True(). Wenn für dieses Argument False zurückgegeben wird, wird der Zeitstempel an die Sommerzeit angepasst. Zu den gültigen Argumentwerten, die False zurückgeben, zählen 0 und False(). Wenn der ignore_dst-Argumentwert ungültig ist, wertet die Funktion die Formel so aus, als ob der ignore_dst-Wert True zurückgäbe. Wenn der ignore_dst-Argumentwert nicht angegeben ist, wertet die Funktion die Formel so aus, als ob der ignore_dst-Wert False zurückgäbe. |
Ist der Parameter ignore_dst auf True gesetzt, wird eine evtl. Zeitumstellung nicht berücksichtigt.
Orte und Zeitzonen
Die Funktion ConvertToLocalTime ruft Informationen zu Orten und Zeitzonen in der ganzen Welt aus der Windows-Registrierung ab. Dies bedeutet, dass der Ortsname, den Sie verwenden möchten, mit dem entsprechenden Namen der Windows-Registrierung übereinstimmen muss, wenn die Funktion verwendet werden soll.
Der genaue Name, unter dem ein Ort in der Windows-Registrierung registriert ist, kann je nach den Spracheinstellungen Ihrer Windows-Installation auch variieren. Dies kommt daher, dass die Namen bestimmter Städte und Länder in unterschiedlichen Sprachen anders geschrieben werden.
Eine komplette Liste der Orte und Zeitzonen finden Sie in der Windows-Registrierung unter:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
Alternativ finden Sie die Liste der Zeitzonen und Orte in der Windows-Systemsteuerung. Öffnen Sie die Systemsteuerung, klicken Sie auf Datum und Uhrzeit und dann auf Zeitzone ändern. Sie können die komplette Liste der Orte oder Länder, mit denen jede Zeitzone verknüpft ist, über das Dropdown-Menü anzeigen.
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 | - | - | - |
Beispiel | Ergebnis |
---|---|
ConvertToLocalTime('2023-08-14 08:39:47','Paris') |
Liefert „2023-08-14 10:39:47“ und den zugehörigen internen Zeitstempel. |
ConvertToLocalTime(UTC(), 'Stockholm') | Liefert die Uhrzeit für Stockholm (an die Sommerzeit angepasst). |
ConvertToLocalTime(UTC(), 'Stockholm', -1) | Liefert die Uhrzeit für Stockholm (nicht an die Sommerzeit angepasst)- |
ConvertToLocalTime(UTC(), 'GMT-05:00') | Liefert die Uhrzeit für die nordamerikanische Ostküste, zum Beispiel New York. Es wird keine Anpassung an die Sommerzeit vorgenommen, da eine GMT-Differenz und kein Ort angegeben wird. |
ConvertToLocalTime(UTC(), 'New York', -1) | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York) ohne Anpassung an die Sommerzeit. |
ConvertToLocalTime(UTC(), 'New York', True()) | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York) ohne Anpassung an die Sommerzeit. |
ConvertToLocalTime(UTC(), 'New York', 0) | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York) mit Anpassung an die Sommerzeit. |
ConvertToLocalTime(UTC(), 'New York', False()) | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York) mit Anpassung an die Sommerzeit. |
Verwenden von GMT-Differenzen in Kombination mit Sommerzeit
Seit der Implementierung der ICU-Bibliotheken (International Components for Unicode) in QlikView November 2018 sind für die Verwendung von GMT-Differenzen (Greenwich Mean Time) in Kombination mit der Sommerzeit zusätzliche Breitengradangaben erforderlich.
GMT ist eine Differenz nach Längengraden (Ost-West), während Sommerzeit eine Differenz nach Breitengrad (Nord-Süd) ist. Beispielsweise gilt für Helsinki (Finnland) und Johannesburg (Südafrika) die gleiche Differenz GMT+02:00, sie haben aber nicht die gleiche Differenz für Sommerzeit. Das bedeutet, dass zusätzlich zur GMT-Differenz für jede Sommerzeitdifferenz Angaben zur Breitengradposition der lokalen Zeitzone (Eingabe der geografischen Zeitzone) erforderlich sind, damit alle Informationen für die lokale Sommerzeit vorhanden sind.