TIMESTAMP 型

適用対象: Databricks SQL Databricks Runtime

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

構文

TIMESTAMP

制限

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

リテラル

TIMESTAMP 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][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]: 秒の小数部の最大 6 桁の数字。

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 で保持されます。 値または値の一部が抽出されるたびに、ローカル セッションのタイムゾーンが適用されます。

例

> 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

関連項目

• TIMESTAMP_NTZ type
• DATE 型
• INTERVAL 型
• cast 関数