# localtime — funkcja skryptu i funkcja wykresu

Ta funkcja zwraca znacznik bieżącego czasu z zegara systemowego dla podanej strefy czasowej.

LocalTime([timezone [, ignoreDST ]])

**Typ zwracanych danych:** podwójne

Argumenty LocalTime

| Argument | Opis |
| --- | --- |
| timezone | Argument timezone określa się jako ciąg znaków zawierający dowolne miejsca geograficzne wymienione w sekcji Strefa czasowa w Panelu sterowania systemu Windows w odniesieniu do obszaru Data i godzina lub jako ciąg znaków w formacie „GMT+hh:mm”. Listę akceptowanych miejsc i stref czasowych prezentujemy także w poniższej tabeli.<br><br>Jeśli nie określono żadnej strefy czasowej, wówczas zwracany jest czas lokalny.<br><br>InformacjaJeśli używasz przesunięcia czasu letniego (tzn. określisz wartość argumentu ignoreDST, 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. Więcej informacji 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/localtime.htm#Using). |
| ignoreDST | Jeżeli ten argument ma wartość True, DST (czas letni) jest ignorowany. Prawidłowe wartości argumentu 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 obejmują `0` i `False()`.<br><br>Jeśli wartość argumentu ignoreDST jest niepoprawna, funkcja ocenia wyrażenie tak, jakby wartość argumentu ignoreDST dawała wynik True (czas letni jest ignorowany). Jeśli wartość argumentu ignoreDST jest nieokreślona, funkcja ocenia wyrażenie tak, jakby wartość argumentu ignoreDST dawała wynik False (znacznik czasu jest korygowany z uwzględnieniem czasu letniego). |

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

Poniższe przykłady opierają się na wywołaniu funkcji w dniu 2023-08-14 o 08:39:47 czasu lokalnego, jeżeli lokalna strefa czasowa środowiska serwera lub komputera to GMT-05:00 w regionie, w którym zaimplementowano czas letni na dany dzień.

Przykłady skryptów

| Przykład | Wynik |
| --- | --- |
| `localtime ()` | Zwraca czas lokalny 2023-08-14 08:39:47. |
| `localtime ('London')` | Zwraca lokalny czas w Londynie, 2023-08-14 13:39:47. |
| `localtime ('GMT+02:00')` | Zwraca czas lokalny w strefie czasowej GMT+02:00, 2023-08-14 14:39:47. Nie dokonuje się żadnej korekty czasu letniego, ponieważ określono przesunięcie czasu GMT, a nie miejsce. |
| `localtime ('Paris',-1)` | Zwraca czas lokalny w Paryżu bez uwzględniania czasu letniego, 2023-08-14 13:39:47. |
| `localtime ('Paris',True())` | Zwraca czas lokalny w Paryżu bez uwzględniania czasu letniego, 2023-08-14 13:39:47. |
| `localtime ('Paris',0)` | Zwraca czas lokalny w Paryżu z uwzględniem czasu letniego, 2023-08-14 14:39:47. |
| `localtime ('Paris',False())` | Zwraca czas lokalny w Paryżu z uwzględniem czasu letniego, 2023-08-14 14:39:47. |

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