TIMESTAMP 類型

適用於:核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

表示包含欄位 year、month、day、hour、minute 和 second 的值以及會話本地時區的數據。 時間戳記值代表絕對的時間點。

語法

TIMESTAMP [ (p) ] | TIMESTAMP_LTZ [ (p) ]
  • p:從 6 到 9,代表分秒數的可選精度。 預設值為 6。 請指定 9 奈秒精度。

Important

TIMESTAMP(p) 精確 7度 –9 適用於 Databricks 執行環境 19 及以上版本,目前仍處於 測試階段。

限制

支援的時間戳記範圍是 -290308-12-21 BCE 19:59:06 GMT 至 +294247-01-10 CE 04:00:54 GMT。

Note

寫入 Delta 或 Parquet 時, TIMESTAMP(p) 精確度高於 1677 至 2262 年的數 6 值限制在 1677 年至 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:至少包含四位數的年份。
  • [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) 一個文字。

zoneId:

  • Z - Zulu 時區 UTC+0
  • +|-[h]h:[m]m
  • 具有其中一個前置詞的標識碼 UTC+、UTC-、GMT+、GMT-、UT+ 或 UT-,以及格式的後綴:
    • +|-h[h]
    • +|-hh[:]mm
    • +|-hh:mm:ss
    • +|-hhmmss
  • 以區域為基礎的區域識別碼, <area>/<city>格式為 , Europe/Paris例如 。

如果未指定月份或日期元件,則預設為 1。 如果未指定小時、分鐘或秒數元件,則預設為 0。 zoneId如果未指定 ,則預設為工作階段時區,

如果常值不代表適當的時間戳記,則 Azure Databricks 就會引發錯誤。

備註

具有當地時區的時間戳會在內部正規化,並以UTC保存。 每當擷取值或部分的值時,就會套用本機會話時區。

要在 Delta Lake 表格中使用 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) 表格限制

  • 冰山表格不支援。
  • 不支援在 Delta Lake 表格中產生的欄位。
  • Delta Lake 表格中的液體聚類欄位不支援。