convertTimezone¶
convertTimezone сдвигает метку времени в указанный часовой пояс, добавляя или вычитая нужный интервал из временной метки.
| Синтаксис | Пример |
|---|---|
convertTimezone(column, target, source) |
convertTimezone("2022-12-28T12:00:00", "Canada/Pacific", "Canada/Eastern") |
| Смещает временную метку из исходного часового пояса в целевой часовой пояс. | Возвращает значение 2022-12-28T09:00:00», отображаемое как 28 декабря 2022 г., 9:00. |
Работать с временными метками и часовыми поясами довольно непросто (легко сделать ошибки и трудно их отловить), поэтому вам следует пытаться использовать convertTimezone только в том случае, если интерпретация ваших данных чувствительна к временным ограничениям.
Например, если вы отслеживаете вход пользователей в систему, то, вероятно, будет не очень критично, если некоторые входы в систему будут учитываться по понедельникам, а не по вторникам, с учетом временного смещения.
Однако если вы используете Glarus BI для чего-то точного, например, для уплаты налогов, то вас, вероятно, гораздо больше будет заботить разница между транзакциями, совершёнными 31 декабря и 1 января.
Параметры¶
column может быть любым из:
- название столбца метки времени,
- пользовательское выражение, которое возвращает отметку времени,
- строка в формате
"YYYY-MM-DDили"YYYY-MM-DDTHH:MM:SS".
target:
- название часового пояса, которое вы хотите присвоить своему столбцу.
source:
- название текущего часового пояса вашего столбца,
- требуется для столбцов или выражений с типом данных «отметка времени без часового пояса»,
- необязательно для столбцов или выражений с типом данных «отметка времени с часовым поясом».
Дополнительные сведения см. в разделе Допустимые типы данных.
Мы также поддерживаем полные названия часовых поясов (например, «Canada/Eastern» вместо «EST»).
Создание пользовательских дат отчёта¶
Допустим, у вас есть данные временных рядов, хранящиеся в одном или нескольких часовых поясах (Исходное время). Вы хотите создать собственные отчётные даты для команды, которая находится в другом часовом поясе, например, в EST.
| Source Time | Team Report Time (EST) |
|---|---|
| December 28, 2022, 10:00:00 | December 28, 2022, 07:00:00 |
| December 28, 2022, 21:00:00 | December 28, 2022, 19:00:00 |
| December 27, 2022, 08:00:00 | December 27, 2022, 05:00:00 |
Если Исходное время хранится как «метка времени с часовым поясом» timestamp with time zone или «метка времени со смещением» timestamp with offset, вам нужно указать только «целевой» часовой пояс:
Если Исходное время хранится как «отметка времени без часового пояса» timestamp without time zone, вы должны указать «исходный» source часовой пояс (который будет зависеть от часового пояса вашей базы данных):
Обычно рекомендуется помечать столбцы convertTimezone названием целевого часового пояса (или добавлять целевой часовой пояс в метаданные модели). Обычно это сильно упрощает жизнь, когда кто-то интересуется, почему числа не совпадают.
Если вы не получаете ожидаемых результатов:
- Проверьте, правильно ли вы указали исходный часовой пояс.
- Спросите у администратора базы данных об «отметке времени с часовым поясом» и «отметке времени без часового пояса» (дополнительную информацию см. в разделе "Допустимые типы данных").
Выбор исходного часового пояса¶
При преобразовании часовых поясов убедитесь, что вы знаете исходный часовой пояс, с которым работаете. Разные столбцы (и даже разные строки) в одной таблице, запросе или модели могут находиться в разных «исходных» часовых поясах.
| Возможный часовой пояс источника | Описание | Пример |
|---|---|---|
| Часовой пояс клиента | Часовой пояс, в котором произошло событие. | Служба веб-аналитики может собирать данные о местном часовом поясе каждого человека, посетившего ваш сайт. |
| Часовой пояс базы данных | Метаданные часового пояса, которые были добавлены к отметкам времени в вашей базе данных. | Общепринятой практикой баз данных является хранение всех временных меток в формате UTC. |
| Нет часового пояса | Отсутствуют метаданные часового пояса metadata | Базы данных не требуют от вас хранения временных меток с метаданными часового пояса. |
| Часовой пояс отчёта Glarus BI | Часовой пояс, который Glarus BI использует для отображения временных меток. | Glarus BI может отображать даты и время в формате PST, даже если даты и время хранятся в вашей базе данных в формате UTC. |
Например, скажем, у вас есть таблица с одной строкой для каждого человека, посетившего ваш сайт. Трудно сказать, просто взглянув на «28 декабря 2022 г., 12:00», является ли это «сырой» отметкой времени:
- хранится с использованием часового пояса вашей базы данных (обычно UTC),
- хранится без метаданных часового пояса (например, если посетитель веб-сайта находится в HKT, то временная метка «28 декабря 2022 г., 12:00» может «неявно» использовать время Гонконга),
- отображается в часовом поясе отчёта Glarus BI.
Для более детальной информации смотри Ограничения.
Допустимые типы данных¶
| Типы данных | Работает с convertTimezone |
|---|---|
| Строка | ❌ |
| Число | ❌ |
| Дата/время | ✅ |
| Условие | ❌ |
| JSON | ❌ |
Информация о типах данных приведена в разделе обучения руководства Metabase (англ.).
Мы используем сочетания «timestamp» и «datetime», чтобы говорить о любом временном типе данных, поддерживаемом Glarus BI.
Если ваши временные метки хранятся в базе данных в виде строк или чисел, администратор может преобразовать их во временные метки на странице 'Метаданные таблиц'.
Чтобы использовать convertTimezone, не сталкиваясь с ошибками или надоедливыми необнаружимыми ошибками, вы должны знать, что существует несколько разновидностей типов данных timestamp:
| Тип данных | Описание | Пример |
|---|---|---|
timestamp with time zone |
Знает о местонахождении. | 2022-12-28T12:00:00 AT TIME ZONE 'America/Toronto' |
timestamp with offset |
Знает о разнице с UTC. | 2022-12-28T12:00:00-04:00 |
timestamp without time zone |
Нет информации о часовом поясе | 2022-12-28T12:00:00 |
Обратите внимание, что первая часть метки времени указана в формате UTC (то же самое, что и GMT). Часовой пояс или смещение говорят вам, сколько времени нужно добавить или вычесть для данного часового пояса.
convertTimezone будет работать со всеми тремя типами меток времени, но результатом convertTimezone всегда будет метка времени без часового пояса.
Ограничения¶
convertTimezone не работает со следующими базами данных:
- Amazon Athena
- Druid
- Google Analytics
- H2
- MongoDB
- Presto
- SparkSQL
- SQLite
Примечания об исходных часовых поясах¶
Glarus BI отображает метки времени без информации о часовом поясе или смещении, поэтому вы должны быть очень осторожны с исходным часовым поясом при использовании convertTimezone.
Часовой пояс отчёта Glarus BI применяется только к типам данных «отметка времени с часовым поясом» timestamp with time zone или «отметка времени со смещением» timestamp with offset. Для примера:
| Временная зона в вашей базе данных | Тип данных | Временная зона отчёта | Отображается как |
|---|---|---|---|
2022-12-28T12:00:00 AT TIME ZONE 'CST' |
timestamp with time zone |
'Canada/Eastern' | Dec 28, 2022, 7:00 AM |
2022-12-28T12:00:00-06:00 |
timestamp with offset |
'Canada/Eastern' | Dec 28, 2022, 7:00 AM |
2022-12-28T12:00:00 |
timestamp without time zone |
'Canada/Eastern' | Dec 28, 2022, 12:00 AM |
Часовой пояс отчёта Glarus BI не будет применяться к выходным данным выражения convertTimezone. Для примера:
convertTimezone("2022-12-28T12:00:00 AT TIME ZONE 'Canada/Central'", "Canada/Pacific", "Canada/Central")
создаст необработанную «метку времени без часового пояса» timestamp without time zone
и отображается в Glarus BI как
Если вы используете convertTimezone для timestamp without time zone, обязательно используйте 'UTC' в качестве часового пояса source, иначе выражение сместит вашу метку времени на неправильную величину.
Для примера, если наша «метка времени без часового пояса» timestamp without time zone только «подразумевается» в CST, мы должны использовать «UTC» в качестве параметра «источник» source, чтобы получить тот же результат, что и выше.
Например, если мы выбираем 'CST', как источник source часового пояса для timestamp without time zone:
мы получим необработанную временную метку без часового пояса timestamp without time zone
которая отобразится в Glarus BI как
Связанные функции¶
В этом разделе рассматриваются функции и формулы, которые работают так же, как выражение convertTimezone, с примечаниями о том, как выбрать лучший вариант для вашего случая использования.
SQL¶
Когда вы запускаете запрос с помощью конструктора запросов, Glarus BI преобразует ваши графические настройки запроса (фильтры, сводки и т.д.) в запрос и запускает этот запрос в вашей базе данных.
Если наши примеры временных меток представляют собой «временную метку без часового пояса», хранящуюся в базе данных PostgreSQL:
то это будет аналогично выражению convertTimezone с параметром source, установленным на 'UTC':
Если source_time является меткой времени с часовым поясом timestamp with time zone или меткой времени со смещением timestamp with offset (например, в базе данных Snowflake), нам не нужно указывать исходный часовой пояс
это будет аналогично выражению:
Помните, что имена часовых поясов зависят от вашей базы данных. Например, Snowflake не принимает большинство сокращений часовых поясов (например, EST).
Таблицы¶
Если наши временные метки образца данных находятся в таблице, где «Исходное время» находится в столбце A, мы можем изменить его на EST, явно вычитая часы:
получая такой же результат:
Python¶
Если данные образца временной метки хранятся в данных pandas, вы можете вначале преобразовать столбец Source Time в объект timestamp с часовым поясом, а затем использовать tz_convert, чтобы изменить часовой пояс на EST:
df['Source Time (UTC)'] = pd.to_timestamp(df['Source Time'], utc=True)
df['Team Report Time (EST)'] = df['Source Time (UTC)'].dt.tz_convert(tz='Canada/Eastern')
это будет аналогично выражению convertTimezone