Interval

Documentación del tipo de dato especial Interval

La familia de tipos de datos que representa intervalos de fecha y hora. Los tipos resultantes del operador INTERVAL.

Estructura:

• Un intervalo de tiempo como valor entero sin signo.
• El tipo de un intervalo.

Tipos de intervalo admitidos:

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

Para cada tipo de intervalo, existe un tipo de dato independiente. Por ejemplo, el intervalo DAY corresponde al tipo de dato IntervalDay:

SELECT toTypeName(INTERVAL 4 DAY)

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

​

Observaciones sobre el uso

Puede usar valores de tipo Interval en operaciones aritméticas con valores de tipo Date y DateTime. Por ejemplo, puede sumar 4 días a la hora actual:

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

También es posible usar múltiples intervalos a la vez:

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

Y para comparar valores con intervalos diferentes:

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);

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

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

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

​

Agregación

sum, avg, min, max y any aplicadas a una columna Interval devuelven un intervalo del mismo tipo. sum suma el número de unidades, mientras que avg calcula su promedio y redondea el resultado a un número entero 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        │
└────────────────┴──────────────┴────────────────────────────┘

Los valores de distintas unidades se convierten a su unidad común antes de agregarse, por lo que sumar un minuto y un segundo da 61 segundos. Month, Quarter y Year no comparten ninguna unidad común con las unidades más pequeñas (un mes no tiene un número fijo de días), por lo que no pueden combinarse con ellas de ninguna manera.

​

Intervalos de tipo mixto

Los intervalos de tipo mixto, por ejemplo, varias horas y varios minutos, se pueden crear con la sintaxis INTERVAL 'value' <from_kind> TO <to_kind>. El resultado es una tupla de dos o más intervalos.

Combinaciones admitidas:

Sintaxis	Formato de cadena	Ejemplo
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

Los campos distintos del primero se validan según el estándar 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)                                     │
└────────────────────────────────────────────┘

Un signo inicial opcional + o - se aplica a todos los componentes:

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- esto es equivalente a:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

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

​

Véase también

• INTERVAL, operador
• toInterval, funciones de conversión de tipos
• avg, función de agregación
• sum, función de agregación