日付と時刻のデータ型

Snowflakeは、日付、時刻、タイムスタンプ（日付と時刻の組み合わせ）を管理するデータ型をサポートしています。Snowflakeは、日付、時刻、タイムスタンプの操作に使用される文字列定数もサポートします。

データ型

Snowflake は以下の日付と時刻のデータ型をサポートしています。

注釈

DATE と TIMESTAMP のデータの場合、Snowflakeは、1582と9999の間の年を使用することをお勧めします。Snowflakeは、この範囲外の数年を受け入れますが、 グレゴリオ暦の制限 のため、1582より前の年は避ける必要があります。

DATE

Snowflakeは、日付を保存するための単一の DATE データ型をサポートしています（時間要素はなし）。

DATE は、最も一般的な形式（YYYY-MM-DD、 DD-MON-YYYY など）の日付を受け入れます。

また、 TIMESTAMP 値はすべて日付の入力として有効ですが、 TIME の情報は切り捨てられます。

DATETIME

DATETIME は、 TIMESTAMP_NTZと同義語です。

TIME

Snowflakeは、時刻を HH:MI:SS の形式で保存するための単一の TIME データ型をサポートしています。

TIME は、小数秒のオプションの精度パラメーター（例: TIME(3)）をサポートします。時間精度の範囲は、0（秒）から9（ナノ秒）までです。デフォルトの精度は9です。

すべての TIME 値は、 00:00:00 ～ 23:59:59.999999999 の間でなければなりません。TIME は「wallclock」時間を内部的に保存し、 TIME 値に対するすべての操作はタイムゾーンを考慮せずに実行されます。

TIMESTAMP_LTZ , TIMESTAMP_NTZ , TIMESTAMP_TZ

Snowflakeは、3種類のタイムスタンプをサポートしています。

TIMESTAMP_LTZ:

TIMESTAMP_LTZ は、 UTC の値を指定された精度で内部に保存します。ただし、すべての操作は、 TIMEZONE セッションパラメーターによって制御される現在のセッションのタイムゾーンで実行されます。

次のものは、 TIMESTAMP_LTZ と同義です。

  • TIMESTAMPLTZ

  • TIMESTAMP WITH LOCAL TIME ZONE

TIMESTAMP_NTZ:

TIMESTAMP_NTZ は、「wallclock」時間を指定された精度で内部に保存します。すべての操作は、タイムゾーンを考慮せずに実行されます。

出力形式にタイムゾーンが含まれる場合、 UTC インジケーター（Z）が表示されます。

TIMESTAMP_NTZ は、 TIMESTAMP のデフォルトです。

次のものは、 TIMESTAMP_NTZ と同義です。

  • TIMESTAMPNTZ

  • TIMESTAMP WITHOUT TIME ZONE

  • DATETIME

TIMESTAMP_TZ:

TIMESTAMP_TZ は、 UTC の値と、関連する*タイムゾーンオフセット*を内部的に保存します。タイムゾーンが提供されない場合は、セッションタイムゾーンオフセットが使用されます。すべての操作は、各レコードに固有のタイムゾーンオフセットで実行されます。

次のものは、 TIMESTAMP_TZ と同義です。

  • TIMESTAMPTZ

  • TIMESTAMP WITH TIME ZONE

TIMESTAMP_TZ 値は、 UTC の時間に基づいて比較されます。たとえば、次の異なるタイムゾーンの異なる時間の比較では、2つの値の UTC 時間が等しいため、 TRUE が返されます。

SELECT '2024-01-01 00:00:00 +0000'::TIMESTAMP_TZ = '2024-01-01 01:00:00 +0100'::TIMESTAMP_TZ;

注意

TIMESTAMP_TZ では、現在特定の値の作成時に、実際の タイムゾーン ではなく、特定のタイムゾーンの オフセット のみが保存されます。これは、 UTC で使用されない夏時間を扱う際に注意することが特に重要です。

たとえば、 TIMEZONE パラメーターを "America/Los_Angeles" に設定して、特定の年の1月に値を TIMESTAMP_TZ に変換すると、タイムゾーンオフセット -0800 が保存されます。後で値に6か月が追加されると、7月にロサンゼルスのオフセットが -0700 であっても、 -0800 オフセットが保持されます。これは、値が作成された後、実際のタイムゾーン情報（"America/Los_Angeles"）が利用できなくなるためです。次のコードサンプルは、この動作を示しています。

SELECT '2024-01-01 12:00:00'::TIMESTAMP_TZ;

+-------------------------------------+
| '2024-01-01 12:00:00'::TIMESTAMP_TZ |
|-------------------------------------|
| 2024-01-01 12:00:00.000 -0800       |
+-------------------------------------+

SELECT DATEADD(MONTH, 6, '2024-01-01 12:00:00'::TIMESTAMP_TZ);

+--------------------------------------------------------+
| DATEADD(MONTH, 6, '2024-01-01 12:00:00'::TIMESTAMP_TZ) |
|--------------------------------------------------------|
| 2024-07-01 12:00:00.000 -0800                          |
+--------------------------------------------------------+

TIMESTAMP

Snowflake内の TIMESTAMP は、 TIMESTAMP_* バリエーションの1つに関連付けられたユーザー指定のエイリアスです。TIMESTAMP が使用されるすべての操作では、関連する TIMESTAMP_* バリエーションが自動的に使用されます。TIMESTAMP データ型はテーブルに保存されません。

TIMESTAMP に関連付けられている TIMESTAMP_* バリエーションは、 TIMESTAMP_TYPE_MAPPING セッションパラメーターで指定されます。デフォルトは TIMESTAMP_NTZ です。

すべてのタイムスタンプのバリエーションと TIMESTAMP エイリアスは、小数秒のオプションの精度パラメーターをサポートします（例: TIMESTAMP(3)）。タイムスタンプの精度は、0（秒）から9（ナノ秒）の範囲です。デフォルトの精度は9です。

タイムスタンプの例

これらの例では、異なるタイムスタンプを使ってテーブルを作成しています。

まず、 TIMESTAMP 列（TIMESTAMP_NTZ にマップされる）を持つテーブルを作成します。

ALTER SESSION SET TIMESTAMP_TYPE_MAPPING = TIMESTAMP_NTZ;

CREATE OR REPLACE TABLE ts_test(ts TIMESTAMP);

DESC TABLE ts_test;

+------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------+
| name | type             | kind   | null? | default | primary key | unique key | check | expression | comment | policy name | privacy domain |
|------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------|
| TS   | TIMESTAMP_NTZ(9) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        | NULL           |
+------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------+

次に、 TIMESTAMP バリエーション（TIMESTAMP_LTZ）のいずれかを明示的に使用します。

CREATE OR REPLACE TABLE ts_test(ts TIMESTAMP_LTZ);

DESC TABLE ts_test;

+------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------+
| name | type             | kind   | null? | default | primary key | unique key | check | expression | comment | policy name | privacy domain |
|------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------|
| TS   | TIMESTAMP_LTZ(9) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    | NULL        | NULL           |
+------+------------------+--------+-------+---------+-------------+------------+-------+------------+---------+-------------+----------------+

異なるタイムゾーンで TIMESTAMP_LTZ を使用します。

CREATE OR REPLACE TABLE ts_test(ts TIMESTAMP_LTZ);

ALTER SESSION SET TIMEZONE = 'America/Los_Angeles';

INSERT INTO ts_test VALUES('2024-01-01 16:00:00');
INSERT INTO ts_test VALUES('2024-01-02 16:00:00 +00:00');

このクエリでは、1月2日のロサンゼルスの時刻は08:00（UTC では16:00）です。

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------------+----------+
| TS                            | HOUR(TS) |
|-------------------------------+----------|
| 2024-01-01 16:00:00.000 -0800 |       16 |
| 2024-01-02 08:00:00.000 -0800 |        8 |
+-------------------------------+----------+

次に、タイムゾーンが異なると時間が変わることに注意します。

ALTER SESSION SET TIMEZONE = 'America/New_York';

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------------+----------+
| TS                            | HOUR(TS) |
|-------------------------------+----------|
| 2024-01-01 19:00:00.000 -0500 |       19 |
| 2024-01-02 11:00:00.000 -0500 |       11 |
+-------------------------------+----------+

テーブルを作成して TIMESTAMP_NTZ を使用します。

CREATE OR REPLACE TABLE ts_test(ts TIMESTAMP_NTZ);

ALTER SESSION SET TIMEZONE = 'America/Los_Angeles';

INSERT INTO ts_test VALUES('2024-01-01 16:00:00');
INSERT INTO ts_test VALUES('2024-01-02 16:00:00 +00:00');

異なるタイムゾーンの時刻は、どちらも同じ「壁時計」の時刻に変換されることに注意してください。

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------+----------+
| TS                      | HOUR(TS) |
|-------------------------+----------|
| 2024-01-01 16:00:00.000 |       16 |
| 2024-01-02 16:00:00.000 |       16 |
+-------------------------+----------+

次に、セッションのタイムゾーンを変更しても、結果には影響しないことに注意してください。

ALTER SESSION SET TIMEZONE = 'America/New_York';

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------+----------+
| TS                      | HOUR(TS) |
|-------------------------+----------|
| 2024-01-01 16:00:00.000 |       16 |
| 2024-01-02 16:00:00.000 |       16 |
+-------------------------+----------+

テーブルを作成して TIMESTAMP_TZ を使用します。

CREATE OR REPLACE TABLE ts_test(ts TIMESTAMP_TZ);

ALTER SESSION SET TIMEZONE = 'America/Los_Angeles';

INSERT INTO ts_test VALUES('2024-01-01 16:00:00');
INSERT INTO ts_test VALUES('2024-01-02 16:00:00 +00:00');

なお、1月1日の記録はセッションのタイムゾーンを継承し、 America/Los_Angeles は数値のタイムゾーンオフセットに変換されました。

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------------+----------+
| TS                            | HOUR(TS) |
|-------------------------------+----------|
| 2024-01-01 16:00:00.000 -0800 |       16 |
| 2024-01-02 16:00:00.000 +0000 |       16 |
+-------------------------------+----------+

次に、セッションのタイムゾーンを変更しても、結果には影響しないことに注意してください。

ALTER SESSION SET TIMEZONE = 'America/New_York';

SELECT ts, HOUR(ts) FROM ts_test;

+-------------------------------+----------+
| TS                            | HOUR(TS) |
|-------------------------------+----------|
| 2024-01-01 16:00:00.000 -0800 |       16 |
| 2024-01-02 16:00:00.000 +0000 |       16 |
+-------------------------------+----------+

サポートされているカレンダー

Snowflakeは、すべての日付とタイムスタンプにグレゴリオ暦を使用します。グレゴリオ暦は1582年に始まりますが、Snowflakeはユリウス暦と一致するように1582年以前の日付（または1582年以前の日付を含む計算）を 調整しない ため、前の年を認識します。UUUU 形式要素は負の年をサポートしています。

日付と時刻の形式

これらのデータ型はすべて、最も妥当であり曖昧でない日付、時刻、または日付と時刻の形式を受け入れます。自動的に形式を検出するように構成されている 場合に、Snowflakeが認識する形式については、 AUTO 検出でサポートされている形式 をご参照ください。

日付と時刻の形式を手動で指定する こともできます。形式を指定するときは、次のテーブルに示す大文字と小文字を区別しない要素を使用できます。

形式要素

説明

YYYY

4桁の [1] 年。

YY

2桁の [1] 年で、TWO_DIGIT_CENTURY_START セッションパラメーターで制御されます。たとえば 1980 に設定すると、79 と 80 の値は、それぞれ 2079 と 1980 として解析されます。

MM

2桁の [1] 月（:code:`01`= Januaryなど）。

MON

月の略称 [2] 。

MMMM

完全な月名 [2] 。

DD

月の2桁の [1] の日（01 ～ 31）。

DY

曜日の略称。

HH24

時間を表す2桁の [1] 数字（00 ～ 23）。:emph:` / ` は指定 AM`できません:code:`PM。

HH12

時間を表す2桁の [1] 数字（01 ～ 12）。AM / PM を指定できます。

AM 、 PM

午前（AM）/午後（PM）。これは HH12 でのみ使用します （HH24 では使用 できません）。

MI

分を表す2桁の [1] 数字（00 ～ 59）。

SS

秒を表す2桁の [1] 数字（00 ～ 59）。

FF[0-9]

0 （秒）から 9 （ナノ秒）の精度を持つ端数秒。例: FF、 FF0、 FF3、 FF9。FF を指定することは、 FF9 （ナノ秒）と同等です。

TZH:TZM 、 TZHTZM 、 TZH

タイムゾーンの2桁の [1] 時間と分、UTC との時差。記号として +/- を付けることができます。

UUUU

ISO 形式 の4桁の年。これは BCE 年の場合は負になります。

[1] 桁数は、値をテキストにシリアル化するときに生成される出力を説明します。テキストを解析する場合、Snowflakeは指定された桁数まで受け入れます。たとえば、日を表す数字は1桁または2桁にすることができます。

:sub:`[2] MON 形式要素の場合、値をテキストにシリアル化するときに生成される出力は、短縮された月名です。MMMM 形式要素の場合、値をテキストにシリアル化するときに生成される出力は、完全な月名です。テキストを解析するとき、Snowflakeは MON と MMMM 両方について3桁の略称または完全な月名を受け入れます。たとえば、「January」または「Jan」、「February」または「Feb」などが、テキストを解析するときに受け入れられます。 `

注釈

  • 日付のみの形式を使用する場合、関連付けられた時刻はその日の午前0時と見なされます。

  • 二重引用符で囲まれた形式または上記の要素以外の形式のものは、解釈されることなく解析/フォーマットされます。

  • 有効な範囲、桁数、ベストプラクティスの詳細については、 日付、時刻、およびタイムスタンプ形式の使用に関する追加情報 をご参照ください。

日付と時刻形式の使用例

次の例では、「 FF 」を使用して、出力の小数秒フィールドに9桁を含める必要があることを示しています。

CREATE OR REPLACE TABLE timestamp_demo_table(
  tstmp TIMESTAMP,
  tstmp_tz TIMESTAMP_TZ,
  tstmp_ntz TIMESTAMP_NTZ,
  tstmp_ltz TIMESTAMP_LTZ);
INSERT INTO timestamp_demo_table (tstmp, tstmp_tz, tstmp_ntz, tstmp_ltz) VALUES (
  '2024-03-12 01:02:03.123456789',
  '2024-03-12 01:02:03.123456789',
  '2024-03-12 01:02:03.123456789',
  '2024-03-12 01:02:03.123456789');

ALTER SESSION SET TIMESTAMP_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF';
ALTER SESSION SET TIMESTAMP_TZ_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF';
ALTER SESSION SET TIMESTAMP_NTZ_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF';
ALTER SESSION SET TIMESTAMP_LTZ_OUTPUT_FORMAT = 'YYYY-MM-DD HH24:MI:SS.FF';

SELECT tstmp, tstmp_tz, tstmp_ntz, tstmp_ltz
  FROM timestamp_demo_table;

+-------------------------------+-------------------------------+-------------------------------+-------------------------------+
| TSTMP                         | TSTMP_TZ                      | TSTMP_NTZ                     | TSTMP_LTZ                     |
|-------------------------------+-------------------------------+-------------------------------+-------------------------------|
| 2024-03-12 01:02:03.123456789 | 2024-03-12 01:02:03.123456789 | 2024-03-12 01:02:03.123456789 | 2024-03-12 01:02:03.123456789 |
+-------------------------------+-------------------------------+-------------------------------+-------------------------------+

日付と時刻の定数

定数 （別名 リテラル）は、固定データ値を指します。Snowflakeは、文字列定数を使用した固定の日付、時刻、またはタイムスタンプ値の指定をサポートしています。文字列定数は常に区切り文字で囲む必要があります。Snowflakeは、単一引用符を使用した文字列定数区切りをサポートしています。

例:

DATE '2024-08-14'
TIME '10:03:56'
TIMESTAMP '2024-08-15 10:59:43'

文字列は、次のパラメーターで設定されたデータ型の入力形式に基づいて、 DATE、 TIME、または TIMESTAMP の値として解析されます。

DATE:

DATE_INPUT_FORMAT

TIME:

TIME_INPUT_FORMAT

TIMESTAMP:

TIMESTAMP_INPUT_FORMAT

例：テーブルの列に特定の日付を挿入します。

CREATE TABLE t1 (d1 DATE);

INSERT INTO t1 (d1) VALUES (DATE '2024-08-15');

間隔定数

間隔定数を使用して、日付、時刻、またはタイムスタンプに期間を追加または削除できます。間隔定数は、次の構文を持つ INTERVAL キーワードを使用して実装されます。

{ + | - } INTERVAL '<integer> [ <date_time_part> ] [ , <integer> [ <date_time_part> ] ... ]'

すべての文字列定数と同様に、Snowflakeでは間隔定数を区切るために一重引用符が必要です。

INTERVAL キーワードは、もう1つの整数と、オプションで1つ以上の日付または時刻部分をサポートします。例:

  • INTERVAL '1 year' は、1年を表します。

  • INTERVAL '4 years, 5 months, 3 hours' は4年5カ月と3時間を表しています。

日付または時刻の部分が指定されていない場合、間隔は秒を表します（例: INTERVAL '2' は INTERVAL '2 seconds' と同一）。これは、日付演算を実行するためのデフォルトの時間単位とは異なります。詳細については、 日付の単純な演算 をご参照ください。

サポートされている日付と時刻部分のリストについては、このトピック内の サポートされている間隔の日付と時刻部分 をご参照ください。

注釈

  • 間隔の増分の順序は重要です。増分は、リストされている順序で加算または減算されます。例：

    • INTERVAL '1 year, 1 day' 最初に1年、次に1日を加算/減算します。

    • INTERVAL '1 day, 1 year' 最初に1日、次に1年を加算/減算します。

    これは、うるう年などのカレンダーイベントの計算に影響を与える可能性があります。

    SELECT TO_DATE ('2019-02-28') + INTERVAL '1 day, 1 year';

    +---------------------------------------------------+
| TO_DATE ('2019-02-28') + INTERVAL '1 DAY, 1 YEAR' |
|---------------------------------------------------|
| 2020-03-01                                        |
+---------------------------------------------------+

    SELECT TO_DATE ('2019-02-28') + INTERVAL '1 year, 1 day';

    +---------------------------------------------------+
| TO_DATE ('2019-02-28') + INTERVAL '1 YEAR, 1 DAY' |
|---------------------------------------------------|
| 2020-02-29                                        |
+---------------------------------------------------+

  • INTERVAL は、データ型ではありません（テーブル列をデータ型 INTERVAL として定義することはできません）。間隔は、日付、時刻、タイムスタンプの計算でのみ使用できます。

  • SQL 変数 で区間を使うことはできません。例えば、次のクエリはエラーを返します。

    SET v1 = '1 year';

SELECT TO_DATE('2023-04-15') + INTERVAL $v1;

サポートされている間隔の日付と時刻部分

INTERVAL キーワードは、次の日付と時刻部分を引数としてサポートします（大文字と小文字の区別なし）。

日付または時刻部分

略語/バリエーション

year

y 、 yy 、 yyy 、 yyyy 、 yr 、 years 、 yrs

quarter

q 、 qtr 、 qtrs 、 quarters

month

mm 、 mon 、 mons 、 months

week

w 、 wk 、 weekofyear 、 woy 、 wy 、 weeks

day

d 、 dd 、 days、 dayofmonth

hour

h 、 hh 、 hr 、 hours 、 hrs

minute

m 、 mi 、 min 、 minutes 、 mins

second

s 、 sec 、 seconds 、 secs

millisecond

ms 、 msec 、 milliseconds

microsecond

us 、 usec 、 microseconds

nanosecond

ns 、 nsec 、 nanosec 、 nsecond 、 nanoseconds 、 nanosecs 、 nseconds

間隔の例

特定の日付に年間隔を追加します。

SELECT TO_DATE('2023-04-15') + INTERVAL '1 year';

+-------------------------------------------+
| TO_DATE('2023-04-15') + INTERVAL '1 YEAR' |
|-------------------------------------------|
| 2024-04-15                                |
+-------------------------------------------+

特定の時間に3時間18分のインターバルを追加します。

SELECT TO_TIME('04:15:29') + INTERVAL '3 hours, 18 minutes';

+------------------------------------------------------+
| TO_TIME('04:15:29') + INTERVAL '3 HOURS, 18 MINUTES' |
|------------------------------------------------------|
| 07:33:29                                             |
+------------------------------------------------------+

CURRENT_TIMESTAMP 関数の出力に複雑な間隔を追加します。

SELECT CURRENT_TIMESTAMP + INTERVAL
    '1 year, 3 quarters, 4 months, 5 weeks, 6 days, 7 minutes, 8 seconds,
    1000 milliseconds, 4000000 microseconds, 5000000001 nanoseconds'
  AS complex_interval1;

以下はサンプル出力です。現在のタイムスタンプが異なる場合は出力が異なります。

+-------------------------------+
| COMPLEX_INTERVAL1             |
|-------------------------------|
| 2026-11-07 18:07:19.875000001 |
+-------------------------------+

特定の日付に、略称の日付/時刻の部分表記を使用した複雑な間隔を追加します。

SELECT TO_DATE('2025-01-17') + INTERVAL
    '1 y, 3 q, 4 mm, 5 w, 6 d, 7 h, 9 m, 8 s,
    1000 ms, 445343232 us, 898498273498 ns'
  AS complex_interval2;

+-------------------------------+
| COMPLEX_INTERVAL2             |
|-------------------------------|
| 2027-03-30 07:31:32.841505498 |
+-------------------------------+

従業員情報のテーブルをクエリし、過去2年と3か月以内に雇用された従業員の名前を返します。

SELECT name, hire_date
  FROM employees
  WHERE hire_date > CURRENT_DATE - INTERVAL '2 y, 3 month';

t1 という名前のテーブルから ts という名前の TIMESTAMP 列をフィルターし、各戻り値に4秒を追加します。

SELECT ts + INTERVAL '4 seconds'
  FROM t1
  WHERE ts > TO_TIMESTAMP('2024-04-05 01:02:03');

日付の単純な演算

日付、時刻、タイムスタンプの加減算に区間定数を使うことに加えて、 DATE 値に { + | - } integer の形式で日数を加減算することもできます。ここで、 integer は加減算する日数を指定します。

注釈

TIME と TIMESTAMP 値はまだ単純な演算をサポートしていません。

日付演算の例

指定した日付に1日を追加します。

SELECT TO_DATE('2024-04-15') + 1;

+---------------------------+
| TO_DATE('2024-04-15') + 1 |
|---------------------------|
| 2024-04-16                |
+---------------------------+

特定の日付から4日引きます。

SELECT TO_DATE('2024-04-15') - 4;

+---------------------------+
| TO_DATE('2024-04-15') - 4 |
|---------------------------|
| 2024-04-11                |
+---------------------------+

employees という名前のテーブルをクエリし、365日以上雇用された退職者の名前を返します。

SELECT name
  FROM employees
  WHERE end_date > start_date + 365;