CURRENT_TIME
CURRENT_TIME
시스템의 현재 시간을 반환해요.
본문
별칭: LOCALTIME
구문 (Syntax)
CURRENT_TIME( [ ] )
CURRENT_TIME
인자 (Arguments)
fract_sec_precision— 이 선택 인자는 시간을 보고할 정밀도를 나타내요. 예를 들어 값 3은 소수점 이하 3자리를 사용하라고 하는 것 (즉, 밀리초 단위로 시간을 지정). 기본 정밀도는 9 (나노초)예요. 유효한 값의 범위는 0~9예요. 그러나 대부분의 플랫폼은 진정한 나노초 정밀도를 지원하지 않으므로, 얻게 되는 정밀도는 지정한 정밀도보다 낮을 수 있어요. 실제로 정밀도는 보통 대략 밀리초(3자리)가 최대예요.
참고: 소수 초(fractional seconds)는 세션의 TIME_OUTPUT_FORMAT 매개변수에 명시적으로 설정된 경우에만 표시돼요 (예: 'HH24:MI:SS.FF').
반환 값 (Returns)
TIME 타입의 값을 반환해요.
사용 노트 (Usage Notes)
- TIMEZONE 매개변수의 설정이 반환 값에 영향을 줘요. 반환된 시간은 세션의 시간대에 있어요.
- 출력에서 시간의 표시 형식은 TIME_OUTPUT_FORMAT 세션 매개변수(기본
HH24:MI:SS)에 의해 결정돼요. - ANSI 표준을 준수하기 위해, 이 함수는 SQL 문장에서 괄호 없이 호출할 수 있어요. 그러나 함수를 호출하는 표현식으로 Snowflake Scripting 변수를 설정하는 경우(예:
my_var := function_name();), 괄호를 포함해야 해요. 자세한 내용은 컨텍스트 함수의 사용 노트를 참고해요. - 반환된 값을 동시 쿼리(같은 가상 웨어하우스가 처리) 간의 정밀한 시간 순서 지정에 사용하지 마세요. 쿼리가 웨어하우스의 서로 다른 컴퓨팅 리소스에 의해 처리될 수 있기 때문이에요.
예제 (Examples)
시간 출력 형식을 HH24:MI:SS.FF로 설정한 다음, 소수 초 정밀도를 먼저 2로, 그다음 4로, 마지막으로 기본값(9)으로 설정해 현재 시간을 반환:
ALTER SESSION SET TIME_OUTPUT_FORMAT = 'HH24:MI:SS.FF';
SELECT CURRENT_TIME(2);
+-----------------+
| CURRENT_TIME(2) |
|-----------------|
| 15:35:51.24 |
+-----------------+
SELECT CURRENT_TIME(4);
+-----------------+
| CURRENT_TIME(4) |
|-----------------|
| 15:36:53.5570 |
+-----------------+
SELECT CURRENT_TIME;
+--------------------+
| CURRENT_TIME |
|--------------------|
| 15:37:29.644000000 |
+--------------------+
더 알아보기
- Snowflake 컨텍스트 함수 — 관련 컨텍스트 함수 전체 목록