メインコンテンツへスキップ
メインコンテンツへスキップ

Interval

日時の間隔を表すデータ型のファミリーです。INTERVAL 演算子の結果として得られる型です。

構造:

  • 符号なし整数値として表される時間間隔。
  • 間隔の型。

サポートされている間隔の種類:

  • NANOSECOND
  • MICROSECOND
  • MILLISECOND
  • SECOND
  • MINUTE
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • QUARTER
  • YEAR

各間隔の種類ごとに、個別のデータ型が定義されています。たとえば、DAY 間隔は IntervalDay データ型に対応します:

SELECT toTypeName(INTERVAL 4 DAY)

┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘

使用上の注意​

Interval 型の値は、Date 型および DateTime 型の値との算術演算に使用できます。たとえば、現在時刻に 4 日を足すことができます。

SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY

┌───current_date_time─┬─plus(now(), toIntervalDay(4))─┐
│ 2019-10-23 10:58:45 │           2019-10-27 10:58:45 │
└─────────────────────┴───────────────────────────────┘

また、複数のインターバルを同時に指定することもできます。

SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)

┌───current_date_time─┬─plus(current_date_time, plus(toIntervalDay(4), toIntervalHour(3)))─┐
│ 2024-08-08 18:31:39 │                                                2024-08-12 21:31:39 │
└─────────────────────┴────────────────────────────────────────────────────────────────────┘

また、異なるインターバル同士の値を比較するには、次のようにします：

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘

混合型インターバル​

複数の時間と複数の分のような混合型インターバルは、INTERVAL 'value' <from_kind> TO <to_kind> 構文を使用して作成できます。 結果は、2 つ以上のインターバルからなるタプルです。

サポートされる組み合わせ:

構文文字列フォーマット例
YEAR TO MONTHY-MINTERVAL '2-6' YEAR TO MONTH
DAY TO HOURD HINTERVAL '5 12' DAY TO HOUR
DAY TO MINUTED H:MINTERVAL '5 12:30' DAY TO MINUTE
DAY TO SECONDD H:M:SINTERVAL '5 12:30:45' DAY TO SECOND
HOUR TO MINUTEH:MINTERVAL '1:30' HOUR TO MINUTE
HOUR TO SECONDH:M:SINTERVAL '1:30:45' HOUR TO SECOND
MINUTE TO SECONDM:SINTERVAL '5:30' MINUTE TO SECOND

先頭以外のフィールドは SQL 標準に従って検証されます。MONTH は 0～11、HOUR は 0～23、MINUTE は 0～59、SECOND は 0～59 です。

SELECT INTERVAL '1:30' HOUR TO MINUTE;

┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

先頭の省略可能な + または - 符号は、すべての部分に適用されます:

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘

関連項目​