Interval

Família de tipos de dados que representa intervalos de data e hora. Os tipos resultantes do operador INTERVAL. Estrutura:

Intervalo de tempo como um valor inteiro sem sinal.
Tipo de um intervalo.

Tipos de intervalo compatíveis:

NANOSECOND
MICROSECOND
MILLISECOND
SECOND
MINUTE
HOUR
DAY
WEEK
MONTH
QUARTER
YEAR

Para cada tipo de intervalo, há um tipo de dado separado. Por exemplo, o intervalo DAY corresponde ao tipo de dado IntervalDay:

SELECT toTypeName(INTERVAL 4 DAY)

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

Observações de uso

Você pode usar valores do tipo Interval em operações aritméticas com valores do tipo Date e DateTime. Por exemplo, é possível adicionar 4 dias ao momento atual:

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

Também é possível usar vários intervalos ao mesmo tempo:

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

E para comparar valores de intervalos diferentes:

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);

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

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

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

Agregação

sum, avg, min, max e any aplicadas a uma coluna Interval retornam um intervalo do mesmo tipo. sum soma o número de unidades, e avg calcula a média delas e arredonda o resultado para um número inteiro de unidades:

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

Valores de unidades diferentes são convertidos para uma unidade comum antes de serem agregados, de modo que somar um minuto e um segundo resulta em 61 segundos. Month, Quarter e Year não têm unidade comum com as unidades menores — um mês não corresponde a um número fixo de dias — e não podem ser combinados com elas de forma alguma.

Intervalos de tipos mistos

Intervalos de tipos mistos, por exemplo, com várias horas e vários minutos, podem ser criados usando a sintaxe INTERVAL 'value' <from_kind> TO <to_kind>. O resultado é uma tupla de dois ou mais intervalos. Combinações suportadas:

Sintaxe	Formato de string	Exemplo
`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`

Os campos que não são iniciais são validados de acordo com o padrão 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)                                     │
└────────────────────────────────────────────┘

Um sinal opcional + ou - no início se aplica a todos os componentes:

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- isso é equivalente a:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

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

Veja também

operador INTERVAL
toInterval funções de conversão de tipos
avg função de agregação
sum função de agregação

Referência de SQL

Tipos de dados

Motores

Funções

Formatos

Configurações

Tabelas do sistema

Lagos de dados

Observações de uso

Agregação

Intervalos de tipos mistos

Veja também

​Observações de uso

​Agregação

​Intervalos de tipos mistos

​Veja também

Observações de uso

Agregação

Intervalos de tipos mistos

Veja também