IS_TIME
IS_TIME (시간 값 확인)
VARIANT 인자가 TIME 값을 포함하는지 확인해요.
본문
구문 (Syntax)
IS_TIME( <variant_expr> )
인자 (Arguments)
variant_expr
VARIANT 타입의 값으로 평가되는 표현식이에요.
반환 값 (Returns)
BOOLEAN 값 또는 NULL을 반환해요.
VARIANT 값이 TIME 값을 포함하면 TRUE, 그렇지 않으면 FALSE를 반환해요.
입력이 NULL이면 오류를 보고하지 않고 NULL을 반환해요.
예시 (Examples)
VARIANT 열의 모든 TIME 값을 반환해요.
참고: TIME 값의 출력 형식은 TIME_OUTPUT_FORMAT 파라미터로 설정돼요. 기본 설정은
HH24:MI:SS예요.
VARIANT 열에 다양한 날짜와 TIME 값을 가진 테이블을 만들고 채워요:
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_TIME 함수를 사용해 데이터에서 TIME 값을 보여줘요. TIME 값만 출력에 반환돼요. DATE와 TIMESTAMP 값은 반환되지 않아요.
SELECT v FROM vardttm WHERE IS_TIME(v);
+------------+
| V |
|------------|
| "20:57:01" |
+------------+
더 알아보기 (Learn more)
- Semi-structured and structured data functions — 반정형·구조화 데이터 함수 모음
- IS_DATE — 날짜 확인
- IS_TIMESTAMP_LTZ — 타임스탬프(LTZ) 확인
- TYPEOF — VARIANT 값 타입 반환