- 카테고리:
반정형 및 정형 데이터 함수 (형식 조건자)
IS_DATE , IS_DATE_VALUE¶
VARIANT 인자에 DATE 값이 포함된 경우 TRUE 를 반환합니다.
IS_DATE 와 IS_DATE_VALUE 는 동의어입니다.
- 참고 항목:
구문¶
IS_DATE( <variant_expr> )
IS_DATE_VALUE( <variant_expr> )
인자¶
variant_expr
VARIANT 형식의 값으로 평가되는 식입니다.
반환¶
BOOLEAN 값 또는 NULL 을 반환합니다.
VARIANT 값에 DATE 값이 포함된 경우 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.
입력값이 NULL이면 오류를 보고하지 않고 NULL을 반환합니다.
예¶
VARIANT 열에 있는 모든 DATE 값을 반환합니다.
참고
날짜 값의 출력 형식은 DATE_OUTPUT_FORMAT 매개 변수를 사용하여 설정됩니다. 기본 설정은 YYYY-MM-DD
입니다.
VARIANT 열에 다양한 날짜 및 시간 값이 포함된 테이블을 만들고 로드합니다.
CREATE OR REPLACE TABLE vardttm (v VARIANT);
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'));
쿼리에서 TYPEOF 함수를 사용하여 VARIANT 열 v
에 저장된 값의 데이터 타입을 표시합니다.
SELECT v, TYPEOF(v) AS type FROM vardttm;
+---------------------------------+---------------+
| V | TYPE |
|---------------------------------+---------------|
| "2024-02-24" | DATE |
| "20:57:01" | TIME |
| "2023-02-24 12:00:00.456" | TIMESTAMP_NTZ |
| "2022-02-24 04:00:00.123 -0800" | TIMESTAMP_LTZ |
| "2021-02-24 14:00:00.123" | TIMESTAMP_NTZ |
| "2020-02-24 15:00:00.123 +0100" | TIMESTAMP_TZ |
+---------------------------------+---------------+
WHERE 절에서 IS_DATE 함수를 사용하여 데이터에 DATE 값을 표시합니다. 출력에는 DATE 값만 반환됩니다. TIME 및 TIMESTAMP 값은 반환되지 않습니다.
SELECT v FROM vardttm WHERE IS_DATE(v);
+--------------+
| V |
|--------------|
| "2024-02-24" |
+--------------+