# converttolocaltime Skript- och diagramfunktion

Konverterar en UTC- eller GMT-tidsmarkör till lokal tid i form av ett dualt värde. Ett antal platser (städer, platser och tidszoner) i hela världen kan användas.

Syntax:

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

Returnerad datatyp: dual

Argument

| Argument | Beskrivning |
| --- | --- |
| timestamp | Tidsmarkören, eller uttrycksresultatet som tidsmarkör som ska konverteras. |
| place | En plats eller tidszon från tabellen över giltiga platser och tidszoner nedan. Du kan också använda GMT eller UTC för att definiera lokal tid. Följande värden och tidsförskjutningsvärden är giltiga:<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>Anteckning om informationOm du använder en DST-förskjutning (d.v.s. att du anger ett ignore\_dst-argumentvärde som utvärderas till False) måste du ange ett ställe snarare än en GMT-förskjutning i place-argumentet. Det beror på att vid justering av sommartid krävs information om breddgrad i tillägg till informationen om längdgrad från en GMT-förskjutning. Se [Använder GMT-förskjutningar i kombination med DST](https://help.qlik.com/sv-SE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm#Using) för information.<br><br>Anteckning om informationDu kan bara använda standardinställda tidsförskjutningar. Det går inte att använda en godtycklig tidsförskjutning, till exempelGMT-04:27. |
| ignore\_dst | Om det här argumentet utvärderas till True ignoreras DST (sommartid). Giltiga argumentvärden som utvärderas till True inkluderar `-1` och `True()`.<br><br>Om det här argumentet utvärderas till False justeras tidsstämpeln för sommartid. Giltiga argumentvärden som utvärderas till False inkluderar `0` och `False()`.<br><br>Om ignore\_dst-argumentvärdet är ogiltigt utvärderar funktionen uttrycket som om ignore\_dst-värdet utvärderas till True. Om ignore\_dst-argumentvärdet inte har angetts utvärderar funktionen uttrycket som om ignore\_dst-värdet utvärderas till False. |

Giltiga platser och tidszoner

| 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/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm)

#### Exempel och resultat:

Skriptexempel

| Exempel | Resultat |
| --- | --- |
| `ConvertToLocalTime('2023-08-14 08:39:47','Paris')` | Returnerar '2023-08-14 10:39:47' och motsvarande interna tidsmarkör. |
| `ConvertToLocalTime(UTC(), 'Stockholm')` | Returnerar tiden för Stockholm, justerat för sommartid. |
| `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | Returnerar tiden för Stockholm, utan justering för sommartid. |
| `ConvertToLocalTime(UTC(), 'GMT-05:00')` | Returnerar tidsangivelsen för Nordamerikas ostkust, t.ex. New York. Ingen justering görs för sommartid eftersom en GMT-förskjutning, snarare än en plats, anges. |
| `ConvertToLocalTime(UTC(), 'New York', -1)` | Returnerar tidsangivelsen för Nordamerikas ostkust (New York) utan justering för sommartid. |
| `ConvertToLocalTime(UTC(), 'New York', True())` | Returnerar tidsangivelsen för Nordamerikas ostkust (New York) utan justering för sommartid. |
| `ConvertToLocalTime(UTC(), 'New York', 0)` | Returnerar tidsangivelsen för Nordamerikas ostkust (New York) justerat för sommartid. |
| `ConvertToLocalTime(UTC(), 'New York', False())` | Returnerar tidsangivelsen för Nordamerikas ostkust (New York) justerat för sommartid. |

## Använder GMT-förskjutningar i kombination med DST

Enligt implementeringen av biblioteken för International Components for Unicode (ICU) i Qlik Sense krävs ytterligare information om breddgrad när förskjutningar av GMT (Greenwich Mean Time) i kombination med DST (Daylight Saving Time, sommartid) används.

GMT är en förskjutning av längdgraden (öst-västlig), medan DST är en förskjutning av breddgraden (nord-sydlig). Helsingfors (Finland) och Johannesburg (Sydafrika) har till exempel samma förskjutning GMT+02:00, men de har inte samma DST-förskjutning. Det innebär att förutom GMT-förskjutningen krävs för DST-förskjutningar information om breddgraden för den lokala tidszonen (inmatad geografisk tidszon) för att få fullständig information om lokala DST-förhållanden.