to_datetime_ntz

Преобразует Unix-метку времени в значение типа DATETIME. Эта функция всегда использует UTC+0, независимо от настроек часового пояса.

Если вы хотите преобразовать Unix-метку времени в значение типа DATETIME на основе текущего часового пояса, используйте функцию to_datetime.

Синтаксис

DATETIME to_datetime_ntz(BIGINT unix_ts, INT scale)

Параметры

Имя	Тип	Обязательный	Описание
unix_ts	BIGINT	Да	Unix-метка времени для преобразования. Например, 1598306400 (секунды) и 1598306400123 (миллисекунды).
scale	INT	Нет	Точность времени. Допустимые значения: 0 — секунды (по умолчанию). 3 — миллисекунды. 6 — микросекунды.

Возвращаемое значение

• При успехе: возвращает значение DATETIME на основе UTC+0.
• При неудаче: возвращает NULL. Распространённые причины:
  • Недопустимое значение scale (не 0, 3 или 6)
  • Значение выходит за пределы диапазона DATETIME (0001-01-01 — 9999-12-31)

Примеры

SELECT to_datetime_ntz(1598306400);
-- Возвращает: 2020-08-24 22:00:00

SELECT to_datetime_ntz(1598306400123456, 6);
-- Возвращает: 2020-08-24 22:00:00.123456