Эта функция возвращает метку текущего времени для указанного часового пояса.
Синтаксис:
LocalTime([timezone [, ignoreDST ]])
Возвращаемые типы данных: двойное значение
| Аргумент | Описание |
|---|---|
| timezone |
Параметр timezone задается как строка, содержащая любое географическое название, указанное в разделе Часовой пояс в расположении Панель управления Windows для поля Date and Time или в виде строки в формате «GMT+чч:мм». Список принятых мест и часовых поясов также представлен в таблице ниже. Если часовой пояс не задан, возвращается местное время. Примечание к информацииЕсли используется переход на летнее время (то есть для аргумента ignoreDST задается значение False), необходимо задать место, а не смещение относительно времени по Гринвичу, в аргументе place. Это объясняется тем, что для коррекции перехода на летнее время требуются данные широты в дополнение к данным долготы, предоставляемым при указании смещения относительно времени по Гринвичу. Для получения дополнительной информации см. раздел Использование смещения относительно времени по Гринвичу в сочетании с переходом на летнее время.
|
| ignoreDST |
Если аргумент имеет значение True, DST (переход на летнее время) игнорируется. Допустимые значения аргумента, возвращающие True, включают -1 и True(). Если этот аргумент имеет значение False, метка времени корректируется с учетом перехода на летнее время. Допустимые значения аргумента, возвращающие результат False, включают 0 и False(). Если аргумент ignoreDST имеет недопустимое значение, функция оценивает выражение так, как если бы значение ignore_dst возвращало результат True. Если значение аргумента ignoreDST не задано, функция оценивает выражение так, как если бы значение ignore_dstвозвращало результат False. |
| 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 | - | - | - |
Примеры и результаты:
Приведенные ниже примеры основаны на функции, вызванной 2023-08-14 в 08:39:47 по местному времени, при этом в среде сервера или компьютера настроен часовой пояс GMT-05:00, и в регионе действует летнее время на указанную дату.
| Пример | Результат |
|---|---|
|
localtime () |
Возвращает местное время 2023-08-14 08:39:47. |
|
localtime ('London') |
Возвращает местное время в Лондоне 2023-08-14 08:39:47. |
|
localtime ('GMT+02:00') |
Возвращает местное время в часовом поясе GMT+02:00, 2023-08-14 14:39:47. Коррекция с учетом перехода на летнее время не выполняется, так как указано смещение относительно времени по Гринвичу, а не место. |
|
localtime ('Paris',-1) |
Возвращает местное время в Париже без учета перехода на летнее время 2023-08-14 13:39:47. |
|
localtime ('Paris',True()) |
Возвращает местное время в Париже без учета перехода на летнее время 2023-08-14 13:39:47. |
|
localtime ('Paris',0) |
Возвращает местное время в Париже с учетом перехода на летнее время 2023-08-14 14:39:47. |
|
localtime ('Paris',False()) |
Возвращает местное время в Париже с учетом перехода на летнее время 2023-08-14 14:39:47. |
Использование смещения относительно времени по Гринвичу в сочетании с переходом на летнее время
После внедрения библиотек Международных компонентов «Юникод» (International Components for Unicode, ICU) в Qlik Sense для использования смещений относительно времени по Гринвичу (GMT, среднее время по Гринвичу) в сочетании с переходом на летнее время (DST) требуется дополнительные данные широты.
Смещение времени по Гринвичу — это смещение по долготе (с востока на запад), а переход на летнее время — это смещение по широте (с севера на юг). Например, Хельсинки (Финляндия) и Йоханнесбург (ЮАР) имеют одинаковое смещение времени по Гринвичу, GMT+02:00, но их переход на летнее время не совпадает. Это значит, что в дополнение к смещению относительно времени по Гринвичу, для коррекции перехода на летнее время требуются данные о широте местного часового пояса (ввод географического часового пояса), чтобы предоставить полную информацию о местных условиях перехода на летнее время.