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

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 │
└─────────────────────────────────────────────────────────────┘

関連項目