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(179999999) < toIntervalMinute(3);

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

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

┌─equals(toIntervalMicrosecond(3600000000), toIntervalHour(1))─┐
│                                                            1 │
└──────────────────────────────────────────────────────────────┘

Агрегация

Функции sum, avg, min, max и any, применённые к столбцу типа Interval, возвращают интервал того же типа. sum суммирует количество единиц, а avg вычисляет их среднее и округляет результат до целого числа единиц:

SELECT
    sum(duration) AS total_duration,
    avg(duration) AS avg_duration,
    toTypeName(total_duration)
FROM VALUES('duration IntervalMillisecond',
    toIntervalMillisecond(100), toIntervalMillisecond(200), toIntervalMillisecond(300))

┌─total_duration─┬─avg_duration─┬─toTypeName(total_duration)─┐
│            600 │          200 │ IntervalMillisecond        │
└────────────────┴──────────────┴────────────────────────────┘

Перед агрегированием значения в разных единицах приводятся к общей единице, поэтому сумма минуты и секунды даёт 61 секунду. У Month, Quarter и Year нет общей единицы с более мелкими единицами (число дней в месяце не фиксировано), поэтому смешивать их с ними вообще нельзя.

Интервалы смешанных типов

Интервалы смешанных типов, например включающие и часы, и минуты, можно создавать с помощью синтаксиса INTERVAL 'value' <from_kind> TO <to_kind>. Результат представляет собой кортеж из двух или более интервалов. Поддерживаемые комбинации:

Синтаксис	Строковый формат	Пример
`YEAR TO MONTH`	`Y-M`	`INTERVAL '2-6' YEAR TO MONTH`
`DAY TO HOUR`	`D H`	`INTERVAL '5 12' DAY TO HOUR`
`DAY TO MINUTE`	`D H:M`	`INTERVAL '5 12:30' DAY TO MINUTE`
`DAY TO SECOND`	`D H:M:S`	`INTERVAL '5 12:30:45' DAY TO SECOND`
`HOUR TO MINUTE`	`H:M`	`INTERVAL '1:30' HOUR TO MINUTE`
`HOUR TO SECOND`	`H:M:S`	`INTERVAL '1:30:45' HOUR TO SECOND`
`MINUTE TO SECOND`	`M:S`	`INTERVAL '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;
-- это эквивалентно:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

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

См. также

оператор INTERVAL
toInterval функции преобразования типов
агрегатная функция avg
агрегатная функция sum

Справочник по SQL

Типы данных

Движки

Функции

Форматы

Настройки

Системные таблицы

Озёра данных

Примечания по использованию

Агрегация

Интервалы смешанных типов

См. также

​Примечания по использованию

​Агрегация

​Интервалы смешанных типов

​См. также

Примечания по использованию

Агрегация

Интервалы смешанных типов

См. также