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

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> )

实参¶

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'));

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

SELECT AS_TIMESTAMP_NTZ(timestamp1) AS timestamp_value
  FROM as_timestamp_example;

+-------------------------+
| TIMESTAMP_VALUE         |
|-------------------------|
| 2024-10-10 12:34:56.000 |
+-------------------------+