# converttolocaltime Skript- und Diagrammfunktion

Konvertiert einen UTC- oder GMT-Zeitstempel in eine lokale Zeit als dualen Wert. Der Standort kann eine beliebige Stadt und Ortsbezeichnung in jeder Zeitzone weltweit sein.

Syntax:

ConvertToLocalTime(timestamp [, place [, ignore\_dst=false]])

Rückgabe Datentyp: dual

Argumente

| Argument | Beschreibung |
| --- | --- |
| timestamp | Der Zeitstempel bzw. eine Formel zur Berechnung eines Zeitstempels zur Umwandlung. |
| place | Ein Ort oder eine Zeitzone aus der nachfolgenden Tabelle der gültigen Orte und Zeitzonen. Alternativ können Sie GMT oder UTC zur Definition einer Ortszeit verwenden. Die folgenden Werte und Zeitdifferenzen sind gültig:<br><br><ul> <li> <span>GMT</span> </li> <li> <span>GMT-12:00 - GMT-01:00</span> </li> <li> <span>GMT+01:00 - GMT+14:00</span> </li> <li> <span>UTC</span> </li> <li> <span>UTC-12:00 - UTC-01:00</span> </li> <li> <span>UTC+01:00 - UTC+14:00</span> </li> </ul><br><br>InformationshinweisFalls Sie eine DST-Verschiebung verwenden (Sie also einen Argumentwert ignore\_dst angeben, der den Wert False setzt), müssen Sie einen Ort anstatt einer GMT-Verschiebung im place-Argument angeben. Dies beruht darauf, dass für die Anpassung der Sommerzeit zusätzlich zu den Längengradinformationen, die durch eine GMT-Verschiebung bereitgestellt werden, Breitengradinformationen erforderlich sind. Informationen finden Sie unter [Verwenden von GMT-Verschiebungen in Verbindung mit DST](https://help.qlik.com/de-DE/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm#Using).<br><br>InformationshinweisSie können nur die Standardzeitdifferenzen verwenden. Es ist nicht möglich, beliebige Zeitdifferenzen anzugeben, zum Beispiel GMT-04:27. |
| ignore\_dst | Falls dieses Argument den Wert True setzt, wird DST (Sommerzeit) ignoriert. Gültige Argumentwerte, die auf True gesetzt werden, enthalten `-1` und `True()`.<br><br>Falls dieses Argument den Wert auf False setzt, wird der Zeitstempel für die Sommerzeit angepasst. Gültige Argumentwerte, die auf False gesetzt werden, enthalten `0` und `False()`.<br><br>Falls das Argument ignore\_dst ungültig ist, wertet die Funktion den Ausdruck aus, als ob der Wert ignore\_dst den Wert True festlegt. Falls das Argument ignore\_dst nicht angegeben wird, wertet die Funktion den Ausdruck aus, als ob der Wert ignore\_dst den Wert False festlegt. |

Gültige Werte

| 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 | - | - | - |

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm)

#### Beispiele und Ergebnisse:

Skriptbeispiele

| Beispiel | Ergebnis |
| --- | --- |
| `ConvertToLocalTime('2023-08-14 08:39:47','Paris')` | Gibt '2023-08-14 10:39:47' und den zugehörigen internen Zeitstempel zurück. |
| `ConvertToLocalTime(UTC(), 'Stockholm')` | Gibt die Uhrzeit für Stockholm zurück und berücksichtigt dabei die Sommerzeit. |
| `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | Gibt die Uhrzeit für Stockholm zurück und berücksichtigt dabei nicht die Sommerzeit. |
| `ConvertToLocalTime(UTC(), 'GMT-05:00')` | Liefert die Uhrzeit für die nordamerikanische Ostküste, zum Beispiel New York. Es wird keine Anpassung für die Sommerzeit vorgenommen, da eine GMT-Verschiebung und kein Ort angegeben ist. |
| `ConvertToLocalTime(UTC(), 'New York', -1)` | Gibt die Uhrzeit für die nordamerikanische Ostküste (New York) zurück, ohne dass die Umstellung der Sommerzeit berücksichtigt wird. |
| `ConvertToLocalTime(UTC(), 'New York', True())` | Gibt die Uhrzeit für die nordamerikanische Ostküste (New York) zurück, ohne dass die Umstellung der Sommerzeit berücksichtigt wird. |
| `ConvertToLocalTime(UTC(), 'New York', 0)` | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York), wobei die Umstellung der Sommerzeit berücksichtigt wird. |
| `ConvertToLocalTime(UTC(), 'New York', False())` | Liefert die Uhrzeit für die nordamerikanische Ostküste (New York), wobei die Umstellung der Sommerzeit berücksichtigt wird. |

## Verwenden von GMT-Verschiebungen in Verbindung mit DST

Anhand der Implementierung der ICU-Bibliotheken (International Components for Unicode in Qlik Sense erfordert die Nutzung von GMT-Verschiebungen (Greenwich Mean Time) in Kombination mit DST (Sommerzeit) zusätzliche Breitengradinformationen.

GMT ist eine Breitengradverschiebung (Ost-West), wohingegen DST eine Längengradverschiebung (Nord-Süd) ist. Helsinki (Finnland) und Johannesburg (Südafrika) haben dieselbe Verschiebung von GMT+02:00, allerdings nicht dieselbe DST-Verschiebung. Dies bedeutet, dass eine beliebige DST-Verschiebung außer der GMT-Verschiebung Informationen zur Breitengradposition der lokalen Zeitzone (geografische Zeitzoneneingabe) benötigt, damit vollständige Informationen über lokale DST-Bedingungen vorliegen.