Interval

Documentação do tipo de dado especial 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