日付と時刻のデータ型¶

インターバルリテラル¶

インターバルリテラルとは、文字列リテラルで期間を指定する式です。次の構文を使用して、インターバルリテラルを指定します。

INTERVAL '[ <sign> ] <string>' { <yearMonthQualifier> | <dayTimeQualifier> }

条件:

• sign`は、正（:code:`+）または負（-）の期間を指定するオプションの記号です。

  デフォルト： +。

• :samp:`{string}`は、期間を表す値です。

• :samp:`{yearMonthQualifier}`は:ref:`label-interval_syntax`で定義されている修飾子です。

• :samp:`{dayTimeQualifier}`は:ref:`label-interval_syntax`で定義されている修飾子です。

インターバル形式¶

特定の形式の文字列リテラルは、間隔値を表すことができます。

年と月の値を指定するには、次の形式を使用します。

'<sign><Y>-<MM>'

条件:

• sign`は、正（:code:`+）または負（-）の期間を指定する必須の記号です。

  デフォルト： +。

• :samp:`{Y}`は年数です。許可される桁数（精度）は、値のデータ型によって異なります。

• :samp:`{MM}`は、``00``から``11``までの月数を表す2桁の数字です。

日、時間、秒、小数秒の値を指定するには、次の形式を使用します。

'<sign>[<D>] [<HH24>]:[<MI>]:[<SS>].[<F>]'

条件:

• sign`は、正（:code:`+）または負（-）の期間を指定する必須の記号です。

  デフォルト： +。

• :samp:`{D}`は日数です。許可される桁数（精度）は、値のデータ型によって異なります。

  次の型の値では、:samp:`{D}`を省略します。

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL HOUR TO SECOND

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• :samp:`{HH24}`は、``00``から``23``までの時間数を表す2桁の数字です。

  次の型の値では、:samp:`{HH24}`を省略します。

  • INTERVAL DAY

  • INTERVAL MINUTE

  • INTERVAL MINUTE TO SECOND

  • INTERVAL SECOND

• :samp:`{MI}`は、``00``から``59``までの分数を表す2桁の数字です。

  次の型の値では、:samp:`{MI}`を省略します。

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY

  • INTERVAL HOUR

  • INTERVAL SECOND

• :samp:`{SS}`は、``00``から``59``までの秒数を表す2桁の数字です。

  次の型の値では、:samp:`{SS}`を省略します。

  • INTERVAL DAY

  • INTERVAL DAY TO HOUR

  • INTERVAL DAY TO MINUTE

  • INTERVAL HOUR

  • INTERVAL HOUR TO MINUTE

  • INTERVAL MINUTE

• :samp:`{F}`は、秒を含むデータ型における小数秒の桁数です。許可される桁数（精度）は、値のデータ型によって異なります。

インターバル形式の文字列リテラルには、次の使用上の注意が適用されます。

• 文字列リテラル表現は、CASTまたはTO_CHAR関数を使用して間隔を明示的にテキスト文字列へキャストする場合に適用されます。

• フィールドの先頭のゼロは精度を指定します。

間隔値の例¶

次のテーブルは、さまざまな間隔値を表す方法を示しています。テーブルに示す値は、間隔値に関する次のルールに従います。

• 正の値の場合、プラス記号:code:`+`はインターバルリテラル値ではオプションですが、インターバル形式の値では必須です。

• インターバルリテラル値では、括弧内の値で精度（許可される桁数）を指定します。例えば、``YEAR(3)``は、年に対して3桁の使用を許可することを指定するものです。

• インターバル形式の値では、主フィールド（先頭のフィールド）には先頭のゼロが含まれません。下位フィールドでは固定桁数を使用します。例えば、``+1-08``のようなYEAR TO MONTH値の場合、年フィールドは先頭のゼロを持たず、月フィールドは2桁で表記されます。

インターバルデータを使用して算術演算を実行する¶

次の例では、インターバルデータを使用して算術演算を実行します。

日付に1年と1か月を追加します。

SELECT TO_DATE('2024-01-01') + INTERVAL '1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2025-02-01                   |
+------------------------------+

日付から1年と1か月を減算します。

SELECT TO_DATE('2024-01-01') + INTERVAL '-1-1' YEAR TO MONTH
  AS date_plus_one_year_one_month;

+------------------------------+
| DATE_PLUS_ONE_YEAR_ONE_MONTH |
|------------------------------|
| 2022-12-01                   |
+------------------------------+

タイムスタンプに期間を追加します。

SELECT TO_TIMESTAMP('2024-01-01 08:08:08.99') + INTERVAL '1 01:01:01.7878' DAY TO SECOND
  AS date_plus_period_of_time;

+--------------------------+
| DATE_PLUS_PERIOD_OF_TIME |
|--------------------------|
| 2024-01-02 09:09:10.777  |
+--------------------------+

次の例では、:doc:`/sql-reference/functions/system_typeof`関数を使用して、クエリが2つのタイムスタンプ値を減算したときにINTERVAL DAY TO SECOND値が返されることを示します。

SELECT SYSTEM$TYPEOF(TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))
  AS type;

+------------------------------------+
| TYPE                               |
|------------------------------------|
| INTERVAL DAY(9) TO SECOND(9)[SB16] |
+------------------------------------+

クエリの結果をインターバル形式で表示するには、式をINTERVAL DAY(2) TO SECOND(2)データ型にキャストして精度を指定し、次にVARCHARへキャストします。

SELECT (TO_TIMESTAMP('2025-10-05 01:02:03') - TO_TIMESTAMP('2025-09-15 11:36:22'))::INTERVAL DAY(2) TO SECOND(2)::VARCHAR
  AS interval_format_result;

+------------------------+
| INTERVAL_FORMAT_RESULT |
|------------------------|
| +19 13:25:41.00        |
+------------------------+

年月インターバルデータの挿入とクエリ¶

INTERVAL YEAR TO MONTH列で募集中のポジションの候補者を追跡するテーブルを作成し、データを挿入します。

CREATE OR REPLACE TABLE candidates (
  name_first VARCHAR,
  name_last VARCHAR,
  duration_of_experience INTERVAL YEAR(2) TO MONTH);

INSERT INTO candidates VALUES ('Jane', 'Smith', '14-4');
INSERT INTO candidates VALUES ('Robert', 'Adams', '0-3');
INSERT INTO candidates VALUES ('Mary', 'Jones', '5-11');

`duration_of_experience``列をデータ型にキャストせずにテーブルをクエリすると、出力には各行の合計月数として列の値が表示されます。

SELECT name_first,
       name_last,
       duration_of_experience AS months_of_experience
  FROM candidates;

+------------+-----------+----------------------+
| NAME_FIRST | NAME_LAST | MONTHS_OF_EXPERIENCE |
|------------+-----------+----------------------|
| Jane       | Smith     |                  172 |
| Robert     | Adams     |                    3 |
| Mary       | Jones     |                   71 |
+------------+-----------+----------------------+

テーブルをクエリして``duration_of_experience``列をVARCHARデータ型にキャストすると、出力には列の値がインターバル形式で表示されます。

SELECT name_first,
       name_last,
       duration_of_experience::VARCHAR AS duration_of_experience
  FROM candidates;

+------------+-----------+------------------------+
| NAME_FIRST | NAME_LAST | DURATION_OF_EXPERIENCE |
|------------+-----------+------------------------|
| Jane       | Smith     | +14-04                 |
| Robert     | Adams     | +0-03                  |
| Mary       | Jones     | +5-11                  |
+------------+-----------+------------------------+

日時インターバルデータを挿入しクエリを実行する¶

INTERVAL HOUR TO SECOND列でさまざまなソフトウェア機能のタイムアウト期間を指定するテーブルを作成し、データを挿入します。

CREATE OR REPLACE TABLE feature_timeouts (
  feature VARCHAR,
  timeout_duration INTERVAL HOUR(2) TO SECOND(0));

INSERT INTO feature_timeouts VALUES ('Feature1', '00:00:30');
INSERT INTO feature_timeouts VALUES ('Feature2', '00:10:00');
INSERT INTO feature_timeouts VALUES ('Feature3', '01:00:00');

テーブルをクエリし、``timeout_duration``列をVARCHARデータ型にキャストします。

SELECT feature,
       timeout_duration::VARCHAR AS timeout_duration
  FROM feature_timeouts;

+----------+------------------+
| FEATURE  | TIMEOUT_DURATION |
|----------+------------------|
| Feature1 | +0:00:30         |
| Feature2 | +0:10:00         |
| Feature3 | +1:00:00         |
+----------+------------------+

テーブルへインターバルデータをコピーし、テーブルのクエリを実行する¶

次の手順を実行して、インターバルデータを含むファイルをステージングし、ファイルをテーブルにコピーします。

1. ファイルシステム上のファイルに、次の内容をコピーします。

   Expand

   1,1-2,28 16:15:14.0
   2,-3-2,-54 16:15:14.123
   

   Show lessSee more

   Scroll to top

   この例では、ファイルが``/examples/intervals/``ディレクトリ内の``interval_values.csv``という名前であることを前提としています。

2. ステージを作成します。

   CopyExpand

   CREATE STAGE interval_stage;
   

   Show lessSee more

   Scroll to top

3. 内部ステージングの場所で、ファイルをステージングします。

   CopyExpand

   PUT file:///examples/intervals/interval_values.csv @~/interval_stage
     AUTO_COMPRESS=false;
   

   Show lessSee more

   Scroll to top

4. データのテーブルを作成します。

   CopyExpand

   CREATE OR REPLACE TABLE sample_interval_values(
     c1 STRING,
     c2 INTERVAL YEAR(1) TO MONTH,
     c3 INTERVAL DAY(2) TO SECOND(3));
   

   Show lessSee more

   Scroll to top

5. 作成したテーブルにステージングされたファイルをロードするには、:doc:`/sql-reference/sql/copy-into-table`コマンドを使用します。

   CopyExpand

   COPY INTO sample_interval_values FROM @~/interval_stage;
   

   Show lessSee more

   Scroll to top

6. ロードされたデータを表示するには、テーブルをクエリし、VARCHAR型にキャストしてロードされたデータを表示します。

   CopyExpand

   SELECT c1,
          c2::VARCHAR AS YEAR_TO_MONTH,
          c3::VARCHAR AS DAY_TO_SECOND,
     FROM sample_interval_values;
   

   Show lessSee more

   Scroll to top
   Expand

   +----+---------------+------------------+
   | C1 | YEAR_TO_MONTH | DAY_TO_SECOND    |
   |----+---------------+------------------|
   | 1  | +1-02         | +28 16:15:14.000 |
   | 2  | -3-02         | -54 16:15:14.123 |
   +----+---------------+------------------+
   

   Show lessSee more

   Scroll to top