类别：

半结构化和结构化数据函数 （类型谓词）

IS_DATE、IS_DATE_VALUE

验证 VARIANT 值是否包含 DATE 值。

IS_DATE 和 IS_DATE_VALUE 是同义的。

另请参阅：

IS_<object_type>、IS_TIME、IS_TIMESTAMP_*

语法

IS_DATE( <variant_expr> )

IS_DATE_VALUE( <variant_expr> )
Copy

实参

variant_expr

VARIANT 类型值计算的表达式。

返回

此函数返回 BOOLEAN 类型的值。

示例

显示 VARIANT 列中的所有 DATE 值。

备注

使用 DATE_OUTPUT_FORMAT 参数设置日期值的输出格式。默认设置为 YYYY-MM-DD。

创建并加载表：

CREATE OR REPLACE TABLE vardttm (v VARIANT);
Copy
INSERT INTO vardttm SELECT TO_VARIANT(TO_DATE('2024-02-24'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIME('20:57:01.123456789+07:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP('2023-02-24 12:00:00.456'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_LTZ('2022-02-24 13:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_NTZ('2021-02-24 14:00:00.123 +01:00'));
INSERT INTO vardttm SELECT TO_VARIANT(TO_TIMESTAMP_TZ('2020-02-24 15:00:00.123 +01:00'));
Copy

显示数据中的 DATE 值：

SELECT * FROM vardttm WHERE IS_DATE(v);
Copy
+--------------+
| V            |
|--------------|
| "2024-02-24" |
+--------------+
语言: 中文