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

Referencia de SQL

Tipos de datos

Motores

Funciones

Formatos

Configuración

Tablas del sistema

Lagos de datos

Observaciones sobre el uso

Agregación

Intervalos de tipo mixto

Véase también

​Observaciones sobre el uso

​Agregación

​Intervalos de tipo mixto

​Véase también

Observaciones sobre el uso

Agregación

Intervalos de tipo mixto

Véase también