# converttolocaltime funkcja skryptu i funkcja wykresu

Przekształca znacznik czasu UTC lub GMT na czas lokalny w postaci wartości podwójnej. Parametr place może być dowolnym miastem, miejscem albo strefą czasową z całego świata.

Składnia:

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

Typ zwracanych danych: wartość podwójna

Argumenty

| Argument | Opis |
| --- | --- |
| timestamp | Znacznik czasu lub wyrażenie dające w wyniku znacznik czasu, które należy przekształcić. |
| place | Miejsce lub strefa czasowa z tabeli poprawnych 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żeli używasz przesunięcia o czas letni (czyli jeżeli określisz, że wartością argumentu ignore\_dst ma być False), musisz określić miejsce zamiast przesunięcia GMT w argumencie place. Jest tak dlatego, że korygowanie o czas letni wymaga informacji o szerokości geograficznej dodatkowo do informacji o długości geograficznej wskazywanych przez przesunięcie GMT. Więcej informacji zawiera temat [Używanie przesunięć GMT w połączeniu z DST](https://help.qlik.com/pl-PL/sense/May2026/Subsystems/Hub/Content/Sense_Hub/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 zwróci wartość True, to DST (czas letni) jest ignorowany. Prawidłowymi wartościami argumentów zwracającymi True są między innymi `-1` i `True()`.<br><br>Jeżeli ten argument zwróci wartość False, znacznik czasu zostanie skorygowany o czas letni. Prawidłowymi wartościami argumentów zwracającymi False są między innymi `0` i `False()`.<br><br>Jeżeli wartość argumentu ignore\_dst jest nieprawidłowa, funkcja oblicza wyrażenie tak, jakby argument ignore\_dst zwracał wartość True. Jeżeli wartość argumentu ignore\_dst nie jest określona, funkcja oblicza wyrażenie tak, jakby argument ignore\_dst zwracał wartość False. |

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

#### Przykłady i wyniki:

Przykłady skryptów

| 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 w Sztokholmie skorygowany o czas letni. |
| `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | Zwraca czas w Sztokholmie bez korygowania o czas letni. |
| `ConvertToLocalTime(UTC(), 'GMT-05:00')` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej, na przykład czas Nowego Jorku. Czas letni nie jest uwzględniany, ponieważ określono przesunięcie GMT zamiast miejsca. |
| `ConvertToLocalTime(UTC(), 'New York', -1)` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowego Jorku), bez korekty do czasu letniego. |
| `ConvertToLocalTime(UTC(), 'New York', True())` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowego Jorku), bez korekty do czasu letniego. |
| `ConvertToLocalTime(UTC(), 'New York', 0)` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowego Jorku), z korektą do czasu letniego. |
| `ConvertToLocalTime(UTC(), 'New York', False())` | Zwraca czas dla wschodniego wybrzeża Ameryki Północnej (Nowego Jorku), z korektą do czasu letniego. |

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

Po zaimplementowaniu bibliotek International Components for Unicode (ICU) w Qlik Sense używanie przesunięć GMT (Greenwich Mean Time) w połączeniu z DST (czasem letnim) wymaga dodatkowych informacji o szerokości geograficznej.

GMT to przesunięcie południkowe (wschód-zachód), podczas gdy DST to przesunięcie równoleżnikowe (północ-południe). Na przykład Helsinki (Finlandia) i Johannesburg (Republika Południowej Afryki) mają to samo przesunięcie GMT+02:00, ale nie mają tego samego przesunięcia czasu letniego. Oznacza to, że oprócz przesunięcia GMT każde przesunięcie czasu letniego wymaga informacji o położeniu równoleżnikowym lokalnej strefy czasowej (wprowadzenia geograficznej strefy czasowej), aby uzyskać pełne informacje o lokalnych warunkach obowiązywania czasu letniego.