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