적용 대상:
Databricks SQL Databricks Runtime
세션 로컬 시간대를 사용하여 년, 월, 일, 시, 분 및 초 필드 값으로 구성된 값을 나타냅니다. 타임스탬프 값은 절대 시점을 나타냅니다.
구문
TIMESTAMP [ (p) ] | TIMESTAMP_LTZ [ (p) ]
-
p: 는 분수초 자리 수를 나타내는 선택적 정밀도69입니다. 기본값은6입니다. 나노초 정밀도로 지정하세요9.
Important
TIMESTAMP(p) 정확하게 7–9 베 타 버전입니다.
제한
지원되는 타임스탬프 범위는 -290308-12-21 BCE 19:59:06 GMT~+294247-01-10 CE 04:00:54 GMT입니다.
Note
델타 또는 파르케에게 보낼 때, TIMESTAMP(p) 1677 6 년부터 2262년까지의 정밀도 이상의 숫자는 제한됩니다.
리터럴
TIMESTAMP timestampString
TIMESTAMP_LTZ timestampString
timestampString
{ '[+|-]yyyy[...]' |
'[+|-]yyyy[...]-[m]m' |
'[+|-]yyyy[...]-[m]m-[d]d' |
'[+|-]yyyy[...]-[m]m-[d]d ' |
'[+|-]yyyy[...]-[m]m-[d]d[T][h]h[:]' |
'[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m[:]' |
'[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s[.]' |
'[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s.[ms][ms][ms][us][us][us][ns][ns][ns][zoneId]' }
-
+또는-: 선택적 기호입니다.-은(는) BCE를 나타내며+은(는) CE(기본값)를 나타냅니다. -
yyyy: 최소 4자리 숫자로 구성된 연도입니다. -
[m]m: 01과 12 사이의 한 자리 또는 두 자리 월입니다. -
[d]d: 01에서 31 사이의 한 자리 또는 두 자리 날짜입니다. -
h[h]: 00에서 23 사이의 한 자리 또는 두 자리 시간입니다. -
m[m]: 00에서 59 사이의 한 자리 또는 두 자리 분입니다. -
s[s]: 00에서 59 사이의 한 자리 또는 두 자리 초입니다. -
[ms][ms][ms][us][us][us][ns][ns][ns]: 최대 9자리 분수 초까지. 리터럴을TIMESTAMP(9)구성하려면 정확히 9자리의 소수자를 지정하세요.
zoneId:
- Z - Zulu 표준 시간대 UTC+0
- +|-[h]h:[m]m
- 접두사로 UTC+, UTC-, GMT+, GMT-, UT+, UT- 중 하나를 사용하고 특정 형식의 접미사가 있는 ID입니다.
- +|-h[h]
- +|-hh[:]mm
- +|-hh:mm:ss
- +|-hhmmss
-
<area>/<city>형식의 지역 기반 영역 ID(예:Europe/Paris)입니다.
월 또는 일 구성 요소가 지정되지 않은 경우 기본값은 1입니다.
시, 분 또는 초 구성 요소를 지정하지 않으면 기본값은 0입니다.
zoneId를 지정하지 않으면 기본적으로 세션 표준 시간대가 사용되며,
리터럴이 적절한 타임스탬프를 나타내지 않으면 Azure Databricks에서 오류가 발생합니다.
노트
현지 시간대가 있는 타임스탬프는 내부적으로 UTC로 정규화되고 유지됩니다. 값 또는 그 일부가 추출될 때마다 로컬 세션 시간대가 적용됩니다.
델타 호수 테이블에서 열을 사용하려면 TIMESTAMP(9) 타임스탬프 정밀도 기능을 활성화하세요:
ALTER TABLE table_name SET TBLPROPERTIES ('delta.feature.timestampPrecision' = 'supported')
이 기능을 활성화하면 테이블 프로토콜이 업그레이드됩니다. 기능을 지원하지 않는 클라이언트는 테이블을 읽거나 쓸 수 없습니다. Delta Lake 기능 호환성 및 프로토콜을 참조하세요.
예제
> SELECT TIMESTAMP'0000';
0000-01-01 00:00:00
> SELECT TIMESTAMP'2020-12-31';
2020-12-31 00:00:00
> SELECT TIMESTAMP'2021-7-1T8:43:28.123456';
2021-07-01 08:43:28.123456
> SELECT current_timezone(), TIMESTAMP'2021-7-1T8:43:28UTC+3';
America/Los_Angeles 2021-06-30 22:43:28
> SELECT CAST('1908-03-15 10:1:17' AS TIMESTAMP)
1908-03-15 10:01:17
> SELECT TIMESTAMP'+10000';
+10000-01-01 00:00:00
> SELECT typeof(TIMESTAMP'2026-08-18 14:30:45.123456789');
TIMESTAMP(9)
> SELECT CAST('2026-08-18 14:30:45.123456789' AS TIMESTAMP(9));
2026-08-18 14:30:45.123456789
TIMESTAMP(9) 표 제한
- 아이스버그 테이블은 지원되지 않습니다.
- 델타 호수 테이블에서 생성된 열은 지원되지 않습니다.
- 델타 호수 표의 액체 클러스터링 열은 지원되지 않습니다.