카테고리:

컨텍스트 함수 (일반)

CURRENT_TIME

시스템의 현재 시간을 반환합니다.

별칭:

LOCALTIME

구문

CURRENT_TIME( [ <fract_sec_precision> ] )

CURRENT_TIME
Copy

인자

fract_sec_precision

이 선택적 인자는 시간을 보고할 정밀도를 나타냅니다. 예를 들어, 값이 3이면 이는 소수점 뒤 3자리를 사용한다는 의미입니다(즉, 밀리초 단위의 정밀도로 시간을 지정함).

기본 정밀도는 9(나노초)입니다.

유효한 값의 범위는 0-9입니다. 그러나 대부분의 플랫폼은 진정한 나노초 정밀도를 지원하지 않습니다. 사용자가 얻는 정밀도는 지정한 정밀도보다 작을 수 있습니다. 실제로 정밀도는 일반적으로 최대 약 밀리초(3자리)입니다.

참고

  • 소수 자리 초는 세션의 TIME_OUTPUT_FORMAT 매개 변수에 명시적으로 설정된 경우에만 표시됩니다(예: 'HH24:MI:SS.FF').

반환

TIME 형식의 값을 반환합니다.

사용법 노트

  • TIMEZONE 매개 변수의 설정은 반환 값에 영향을 줍니다. 반환된 시간은 세션의 타임존에 있습니다.

  • 출력에서 시간의 표시 형식은 TIME_OUTPUT_FORMAT 세션 매개 변수(기본값 HH24:MI:SS)에 의해 결정됩니다.

  • ANSI 표준을 준수하기 위해 이 함수는 SQL 문에서 괄호 없이 호출할 수 있습니다.

    그러나 Snowflake Scripting 변수 를 함수를 호출하는 식(예: my_var := <함수_이름>();)으로 설정하는 경우 괄호를 포함해야 합니다. 자세한 내용은 컨텍스트 함수의 사용법 노트 를 참조하십시오.

  • 동시 쿼리(동일한 가상 웨어하우스에서 처리됨) 사이의 정확한 시간 정렬에 반환 값을 사용하지 마십시오. 쿼리가 웨어하우스의 다른 컴퓨팅 리소스에서 처리될 수 있기 때문입니다.

시간 출력 형식을 HH24:MI:SS.FF 로 설정한 다음, 소수 자리 초 정밀도를 먼저 2, 그리고 4로 설정한 다음 기본값(9)으로 현재 시간을 반환합니다.

ALTER SESSION SET TIME_OUTPUT_FORMAT = 'HH24:MI:SS.FF';

SELECT CURRENT_TIME(2);
Copy
+-----------------+
| CURRENT_TIME(2) |
|-----------------|
| 15:35:51.24     |
+-----------------+
SELECT CURRENT_TIME(4);
Copy
+-----------------+
| CURRENT_TIME(4) |
|-----------------|
| 15:36:53.5570   |
+-----------------+
SELECT CURRENT_TIME;
Copy
+--------------------+
| CURRENT_TIME       |
|--------------------|
| 15:37:29.644000000 |
+--------------------+