# localtime Skript- und Diagrammfunktion

Diese Funktion liefert einen Zeitstempel der aktuellen Uhrzeit, bezogen auf eine bestimmte Zeitzone.

Syntax:

LocalTime([timezone [, ignoreDST ]])

Rückgabe Datentyp: dual

Argumente

| Argument | Beschreibung |
| --- | --- |
| timezone | Für den Parameter timezone ist ein String anzugeben, der einer Ortsbezeichnung entspricht, wie sie in der Windows-Systemsteuerung bei Zeitzone unter Datum und Uhrzeit angegeben ist. Auch Angaben der Form 'GMT+hh:mm' können verwendet werden. Eine Liste mit akzeptierten Orten und Zeitzonen ist auch in der unten stehenden Tabelle aufgeführt.<br><br>Wenn keine Zeitzone angegeben ist, wird die lokale Uhrzeit ausgegeben.<br><br>InformationshinweisFalls Sie eine DST-Verschiebung verwenden (Sie also einen Argumentwert ignoreDST 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. Weitere Informationen finden Sie unter [Verwenden von GMT-Verschiebungen in Verbindung mit DST](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/localtime.htm#Using). |
| ignoreDST | 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 ignoreDST ungültig ist, wertet die Funktion den Ausdruck aus, als ob der Wert ignore\_dst den Wert True festlegt. Falls das Argument ignoreDST 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 | - | - | - |

Beispiele und Ergebnisse:

Die unten stehenden Beispiele basieren auf der Funktion, die mit dem Zeitstempel 2023-08-14 08:39:47 lokaler Zeit aufgerufen wurde, wobei die lokale Zeitzone der Server- oder Desktopumgebung GMT-05:00 ist und sich in einer Region befindet, die seit diesem aufgelisteten Datum die Sommerzeit eingeführt hat.

Skriptbeispiele

| Beispiel | Ergebnis |
| --- | --- |
| `localtime ()` | Liefert die lokale Zeit 2023-08-14 08:39:47. |
| `localtime ('London')` | Liefert die lokale Zeit 2023-08-14 13:39:47 in London. |
| `localtime ('GMT+02:00')` | Liefert die lokale Zeit in der Zeitzone GMT+02:00, 2023-08-14 14:39:47. Es wird keine Anpassung für die Sommerzeit vorgenommen, da eine GMT-Verschiebung und kein Ort angegeben ist. |
| `localtime ('Paris',-1)` | Liefert die lokale Zeit in Paris ohne Berücksichtigung der Sommerzeit, 2023-08-14 13:39:47. |
| `localtime ('Paris',True())` | Liefert die lokale Zeit in Paris ohne Berücksichtigung der Sommerzeit, 2023-08-14 13:39:47. |
| `localtime ('Paris',0)` | Liefert die lokale Zeit in Paris unter Berücksichtigung der Sommerzeit, 2023-08-14 14:39:47. |
| `localtime ('Paris',False())` | Liefert die lokale Zeit in Paris unter Berücksichtigung der Sommerzeit, 2023-08-14 14:39:47. |

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