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 表示微秒。

返回值

• 成功时：返回基于 UTC+0 的 DATETIME 值。
• 失败时：返回 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