Konverterar en UTC- eller GMT-tidsmarkör till lokal tid i form av ett dualt värde.
Syntax:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Typ av returdata: dual
| Argument | Beskrivning |
|---|---|
| timestamp | Det datum som ska utvärderas som en tidsangivelse eller det uttryck som resulterar i en tidsangivelse och ska konverteras, till exempel ”2012-10-12”. |
| place |
En plats eller en tidszon från tabellen över platser och tidszoner nedan. Du kan även använda GMT ellerUTC för att definiera lokal tid. Följande värden och tidsförskjutningsvärden är giltiga:
Anteckning om informationOm du använder en DST-offset (d.v.s. du anger ett ignore_dst -argumentvärde som utvärderas till False) måste du ange en plats i stället för en GMT-offset i place-argumentet. Detta beror på att justering för sommartid kräver information om breddgrad utöver den information om längdgrad som tillhandahålls av en GMT-offset. Mer information finns i Använda GMT-offsets i kombination med sommartid.
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 argumentet utvärderas till True ignoreras DST (sommartid). Giltiga argumentvärden som utvärderar True inkluderar -1 och True(). Om det här argumentet utvärderas till False justeras tidsmarkören för sommartid. Giltiga argumentvärden som utvärderar False inkluderar 0 och False(). 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 anges utvärderar funktionen uttrycket som om ignore_dst-värdet utvärderas till False. |
Resultatet justeras för sommartid, såvida inte ignore_dst har ställts in på True.
Platser och tidszoner
Funktionen ConvertToLocalTime hämtar information om platser och tidszoner runt om i världen från Windows-registret. Detta betyder att för att funktionen ska fungera måste namnet på den plats som du vill använda matcha motsvarande namn i Windows-registret.
Det exakta namn som finns registrerat för en plats i Windows-registret kan också komma att ändras utifrån språkinställningarna i din Windows-installation. Vissa städer och länder stavas nämligen olika på olika språk.
Den kompletta listan över platser och tidszoner i Windows-registret hittar du här:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
Du kan även hitta listan över tidszoner och platser i Windows kontrollpanel. Öppna Kontrollpanelen, klicka på Datum och tid och därefter Ändra tidszon. Den kompletta listan över städer och länder inom varje tidszon finns i listrutan.
| 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 | - | - | - |
| 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-offset i stället för 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ända GMT-offsets i kombination med sommartid
Efter implementeringen av ICU-bibliotek (International Components for Unicode) i QlikView november 2018 krävs ytterligare information om breddgrad för att kunna använda GMT-offset (Greenwich Mean Time) i kombination med sommartid.
GMT är en longitudinell (öst-västlig) offset, medan sommartid är en latitudinell (nord-sydlig) offset. Helsingfors (Finland) och Johannesburg (Sydafrika) har till exempel samma GMT+02:00-offset, men de har inte samma förskjutning för sommartid. Detta innebär att det utöver GMT-offset även krävs information om den lokala tidszonens latitudposition (geografisk tidszonsinmatning) för att få fullständig information om lokal tillämpning av sommartid.
