- 카테고리:
컨텍스트 함수 (일반)
LOCALTIMESTAMP¶
현지 타임존에 있는 시스템의 현재 타임스탬프를 반환합니다.
CURRENT_TIMESTAMP 에 대한 ANSI 호환 별칭입니다.
구문¶
LOCALTIMESTAMP( [ <fract_sec_precision> ] )
LOCALTIMESTAMP
인자¶
fract_sec_precision
이 선택적 인자는 시간을 보고할 정밀도를 나타냅니다. 예를 들어, 값이 3이면 이는 소수점 뒤 3자리를 사용한다는 의미입니다(즉, 밀리초 단위의 정밀도로 시간을 지정함).
기본 정밀도는 9(나노초)입니다.
유효한 값의 범위는 0-9입니다. 그러나 대부분의 플랫폼은 진정한 나노초 정밀도를 지원하지 않습니다. 사용자가 얻는 정밀도는 지정한 정밀도보다 작을 수 있습니다. 실제로 정밀도는 일반적으로 최대 약 밀리초(3자리)입니다.
참고
소수 자리 초는 세션의 TIMESTAMP_OUTPUT_FORMAT 매개 변수에 명시적으로 설정된 경우에만 표시됩니다(예:
'YYYY-MM-DD HH24:MI:SS.FF'
).
반환¶
현재 시스템 시간을 반환합니다. 반환된 값의 데이터 타입은 TIMESTAMP_LTZ 입니다.
사용법 노트¶
TIMEZONE 매개 변수의 설정은 반환 값에 영향을 줍니다. 반환된 타임스탬프는 세션의 타임존에 있습니다.
TIMESTAMP_TYPE_MAPPING 매개 변수의 설정은 반환 값에 영향을 미치지 않습니다.
동시 쿼리(동일한 가상 웨어하우스에서 처리됨) 사이의 정확한 시간 정렬에 반환 값을 사용하지 마십시오. 쿼리가 웨어하우스의 다른 컴퓨팅 리소스에서 처리될 수 있기 때문입니다.
ANSI 표준을 준수하기 위해 이 함수는 SQL 문에서 괄호 없이 호출할 수 있습니다.
그러나 Snowflake Scripting 변수 를 함수를 호출하는 식(예:
my_var := LOCALTIMESTAMP();
)으로 설정하는 경우 괄호를 포함해야 합니다. 자세한 내용은 컨텍스트 함수의 사용법 노트 를 참조하십시오.
예¶
현재 현지 시간과 현지 타임스탬프를 표시합니다.
SELECT LOCALTIME(), LOCALTIMESTAMP();
+-------------+-------------------------------+
| LOCALTIME() | LOCALTIMESTAMP() |
|-------------+-------------------------------|
| 07:58:09 | 2024-04-18 07:58:09.848 -0700 |
+-------------+-------------------------------+