类别：

半结构化和结构化数据函数 （类型转换）

AS_TIMESTAMP_*

将 VARIANT 值转换为相应的 时间戳 值：

  • AS_TIMESTAMP_LTZ （具有本地时区的值）

  • AS_TIMESTAMP_NTZ （不带时区的值）

  • AS_TIMESTAMP_TZ （带时区的值）

另请参阅：

AS_<object_type>、AS_DATE、AS_TIME

语法

AS_TIMESTAMP_LTZ( <variant_expr> )

AS_TIMESTAMP_NTZ( <variant_expr> )

AS_TIMESTAMP_TZ( <variant_expr> )
Copy

实参

variant_expr

VARIANT 类型值计算的表达式。

返回

函数返回时间戳类型的值或 NULL：

  • 如果 variant_expr 实参中的值的类型是时间戳类型，则函数返回相同时间戳类型的值。

  • 如果 variant_expr 实参中的值类型与输出值的类型不匹配，则函数返回 NULL。

  • 如果 variant_expr 实参为 NULL，则该函数返回 NULL。

示例

创建一个表并将数据加载到其中：

CREATE OR REPLACE TABLE as_timestamp_example (timestamp1 VARIANT);

INSERT INTO as_timestamp_example (timestamp1)
  SELECT TO_VARIANT(TO_TIMESTAMP_NTZ('2024-10-10 12:34:56'));
Copy

在查询中使用 AS_TIMESTAMP_NTZ 函数将 VARIANT 值转换为 TIMESTAMP_NTZ 值：

SELECT AS_TIMESTAMP_NTZ(timestamp1) AS timestamp_value
  FROM as_timestamp_example;
Copy
+-------------------------+
| TIMESTAMP_VALUE         |
|-------------------------|
| 2024-10-10 12:34:56.000 |
+-------------------------+
语言: 中文