TIMESTAMP 型

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

セッションのローカル タイム ゾーンを使用して、年、月、日、時、分、秒のフィールドの値を構成する値を表します。 タイムスタンプ値は、絶対的な特定の時点を表します。

構文

TIMESTAMP [ (p) ] | TIMESTAMP_LTZ [ (p) ]
  • p: 6 から 9までの任意の精度で、分数秒数を表します。 既定値は 6 です。 ナノ秒精度のために 9 を指定してください。

Important

TIMESTAMP(p) 精度では 7–9 は ベータです。

制限

サポートされているタイムスタンプの範囲は -290308-12-21 BCE 19:59:06 GMT から +294247-01-10 CE 04:00:54 GMT です。

Note

デルタやパルケットに書く際、6以上の精度で書くTIMESTAMP(p)値は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: 少なくとも 4 桁の数字で構成される年。
  • [m]m: 01 から 12 までの月を表す 1 桁または 2 桁の数字。
  • [d]d: 01 から 31 までの日を表す 1 桁または 2 桁の数字。
  • h[h]: 00 から 23 までの時間を表す 1 桁または 2 桁の数字。
  • m[m]: 00 から 59 までの分を表す 1 桁または 2 桁の数字。
  • s[s]: 00 から 59 までの秒を表す 1 桁または 2 桁の数字。
  • [ms][ms][ms][us][us][us][ns][ns][ns]:最大9桁の分数秒まで。 TIMESTAMP(9)リテラルを構成するために正確に9桁の分数を指定します。

zoneId:

  • Z - 協定世界時ゾーン UTC+0
  • +|-[h]h:[m]m
  • プレフィックス (UTC+、UTC-、GMT+、GMT-、UT+ または UT-) の 1 つを持つ 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) テーブルの制限

  • アイスバーグテーブルはサポートされていません。
  • Delta Lakeのテーブルで生成された列はサポートされていません。
  • デルタ湖のテーブルにおける液体クラスタリングカラムはサポートされていません。
  • 最終更新: