Преобразует формат метки времени UTC или GMT в местное время и выводит в виде двойного значения.
Синтаксис:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Тип возврата данных: двойное значение
Аргументы:
| Аргумент | Описание |
|---|---|
| timestamp | Дата для вычисления в виде метки времени или выражения, определяемого по метке времени, для преобразования, например '2012-10-12'. |
| place |
Город или часовой пояс из таблицы городов и часовых поясов, указанной ниже. Либо можно использовать GMT или UTC для определения местного времени. Следующие значения и диапазоны смещения времени являются действительными.
Примечание к информацииМожно использовать только стандартные значения смещения времени. Невозможно использовать произвольное смещение времени, например GMT-04:27.
|
| ignore_dst | Установите значение True, чтобы игнорировать DST (переход на летнее время). |
Результирующее время настраивается в соответствии с переходом на летнее время, если для параметра ignore_dst не задано значение True.
Города и часовые пояса
Функция ConvertToLocalTime извлекает сведения о городах и часовых поясах мира из реестра Windows. Это означает, что для надлежащей работы функции название города, которое необходимо использовать, должно соответствовать наванию города в реестре Windows.
Точное название, под которым город фигурирует в реестре Windows, может измениться в зависимости от параметров языка установки Windows. Это обусловлено разным написанием названий определенных городов и стран на разных языках.
Полный список городов и часовых поясов в реестре Windows находится в следующем расположении:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
Кроме того, со списком городов и часовых поясов можно ознакомиться на панели управления Windows. Откройте Панель управления, щелкните параметры Дата и время и выберите Изменить часовой пояс. В раскрывающемся меню отобразится полный список городов и стран, связанных с каждым часовым поясом.
Примеры и результаты:
| Пример | Результат |
|---|---|
| ConvertToLocalTime('2007-11-10 23:59:00','Paris') | Возвращает «2007-11-11 00:59:00» и соответствующее внутреннее представление метки времени. |
| ConvertToLocalTime(UTC(), 'GMT-05:00') | Возвращает время для североамериканского восточного побережья, например Нью-Йорка. |
| ConvertToLocalTime(UTC(), 'GMT-05:00', True) | Возвращает время для североамериканского восточного побережья, например Нью-Йорка, без учета соответствия переходу на летнее время. |
Использование смещений GMT в сочетании с DST
После внедрения библиотек международных компонентов для Unicode (ICU) в QlikView в ноябре 2018 года для использования смещений GMT (среднее время по Гринвичу) в сочетании с переходом на летнее время (DST) требуется дополнительная информация о широте.
GMT — продольное смещение (восток-запад), тогда как DST — широтное смещение (север-юг). Например, Хельсинки (Финляндия) и Йоханнесбург (Южная Африка) используют одинаковое смещение GMT+02:00, однако разные смещения DST. Это означает, что, помимо смещения GMT, для любого смещения DST необходима информация о широтном положении местного часового пояса (географический часовой пояс), чтобы иметь полную информацию о локальных условиях DST.
