# converttolocaltime — funkcja skryptu i funkcja wykresu

Przekształca znacznik czasu UTC lub GMT na czas lokalny w postaci wartości podwójnej.

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

**Typ zwracanych danych:** podwójne

Argumenty ConvertToLocalTime

| Argument | Opis |
| --- | --- |
| timestamp | Data do oceny jako znacznik czasu lub wyrażenie dające w wyniku znacznik czasu, którą należy przekształcić, na przykład „2012-10-12”. |
| place | Miejsce lub strefa czasowa z tabeli miejsc i stref czasowych poniżej. W celu określenia czasu lokalnego można także użyć parametru GMT lub UTC. Prawidłowe są następujące wartości i zakresy przesunięcia czasu:<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>InformacjaJeśli używasz przesunięcia czasu letniego (tzn. określisz wartość argumentu ignore\_dst, której wynikiem będzie False), w argumencie place musisz określić miejsce, a nie przesunięcie GMT. Jest tak dlatego, że dostosowanie czasu letniego wymaga informacji o szerokości geograficznej oprócz informacji o długości geograficznej dostarczonych przez przesunięcie względem GMT. Informacje zawiera temat [Używanie przesunięć GMT w połączeniu z czasem letnim](https://help.qlik.com/pl-PL/qlikview/September2026/Subsystems/Client/Content/QV_QlikView/Scripting/DateAndTimeFunctions/converttolocaltime.htm#Using).<br><br>InformacjaMożna użyć wyłącznie standardowych przesunięć czasu. Nie można użyć dowolnego przesunięcia czasu, na przykład GMT-04:27. |
| ignore\_dst | Jeżeli ten argument ma wartość True, DST (czas letni) jest ignorowany. Prawidłowe wartości argumentu dające wynik True obejmują `-1` i `True()`.<br><br>Jeżeli ten argument daje wynik False, znacznik czasu jest korygowany o czas letni. Prawidłowe wartości argumentu dające wynik False obejmują `0` i `False()`.<br><br>Jeśli wartość argumentu ignore\_dst jest niepoprawna, funkcja ocenia wyrażenie tak, jakby wartość argumentu ignore\_dst dawała w wyniku True. Jeśli wartość argumentu ignore\_dst nie zostanie określona, funkcja ocenia wyrażenie tak, jakby wartość ignore\_dst dawała w wyniku False. |

Otrzymany czas jest korygowany do czasu letniego, chyba że parametr ignore\_dst ma wartość True.

## Miejsca i strefy czasowe

Funkcja ConvertToLocalTime pobiera informacje o miejscach i strefach czasowych z całego świata z rejestru systemu Windows. Oznacza to, że aby ta funkcja działała nazwa miejsca, której użytkownik chce użyć musi być zgodna z odpowiadającą nazwą w rejestrze systemu Windows.

Dokładna nazwa, pod jaką miejsce jest zarejestrowane w rejestrze systemu Windows, może również ulegać zmianom odpowiednio do ustawień języka w konkretnej instalacji systemu Windows. Dzieje się tak dlatego, że nazwy niektórych miast i krajów mają różną pisownię w różnych językach.

Pełna lista nazw i stref czasowych jest dostępna w rejestrze systemu Windows w gałęzi:

HKEY\_LOCAL\_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones

Listę stref czasowych i miejsc można również znaleźć w Panelu sterowania systemu Windows. Otwórz*Panel sterowania*, kliknij pozycję *Data i godzina*, a następnie przycisk *Zmień strefę czasową*. Zostanie wyświetlona pełna lista miast lub krajów powiązanych z poszczególnymi strefami czasowymi z menu rozwijanego.

Poprawne miejsca i strefy czasowe

| A-C | D-K | L-R | S-Z |
| --- | --- | --- | --- |
| Abu Dhabi | Darwin | La Paz | Samoa |
| Adelaide | Dhaka | Lima | Santiago |
| Alaska | Eastern Time (US &<br>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<br>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<br>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 | - | - | - |

Przykłady i wyniki

| Przykład | Wynik |
| --- | --- |
| `ConvertToLocalTime('2023-08-14 08:39:47','Paris')` | Zwraca wartość „2023-08-14 10:39:47” oraz odpowiadającą wewnętrzną reprezentację znacznika czasu. |
| `ConvertToLocalTime(UTC(), 'Stockholm')` | Zwraca czas dla Sztokholmu, z korektą uwzględniającą czas letni. |
| `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | Zwraca czas dla Sztokholmu, bez korekty uwzględniającej czas letni. |
| `ConvertToLocalTime(UTC(), 'GMT-05:00')` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej, na przykład czas Nowego Jorku. Nie dokonuje się żadnej korekty czasu letniego, ponieważ określono przesunięcie czasu GMT, a nie miejsce. |
| `ConvertToLocalTime(UTC(), 'New York', -1)` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowy Jork), bez korekty uwzględniającej czas letni. |
| `ConvertToLocalTime(UTC(), 'New York', True())` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowy Jork), bez korekty uwzględniającej czas letni. |
| `ConvertToLocalTime(UTC(), 'New York', 0)` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowy Jork) z korektą uwzględniającą czas letni. |
| `ConvertToLocalTime(UTC(), 'New York', False())` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowy Jork) z korektą uwzględniającą czas letni. |

## Używanie przesunięć GMT w połączeniu z czasem letnim

Po wdrożeniu bibliotek International Components for Unicode (ICU) w QlikView w listopadzie 2018 r. użycie przesunięć GMT (czasu Greenwich) w połączeniu z czasem letnim wymaga dodatkowych informacji o szerokości geograficznej.

GMT ma przesunięcie wzdłużne (wschód-zachód), podczas gdy czas letni to przesunięcie równoleżnikowe (północ-południe). Na przykład Helsinki (Finlandia) i Johannesburg (RPA) mają to samo przesunięcie GMT+02:00, ale nie mają tego samego przesunięcia czasu letniego. Oznacza to, że w dodatku do przesunięcia GMT każde przesunięcie czasu letniego wymaga informacji o szerokości geograficznej lokalnej strefy czasowej (wprowadzenia geograficznej strefy czasowej), aby uzyskać pełną informację o lokalnych warunkach czasu letniego.