次の方法で共有

TIMESTAMP 型

  • [アーティクル]

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

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

構文

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 ではエラーが発生します。

メモ

ローカル timezone を含むタイムスタンプは内部的に正規化され、UTC で保持されます。 値またはその一部が抽出されるたびに、ローカル セッション timezone が適用されます。

例

> 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