Interval

Famille de types de données représentant des intervalles de temps et de dates. Il s’agit des types résultant de l’opérateur INTERVAL. Structure :

Intervalle de temps sous la forme d’une valeur entière non signée.
Type d’intervalle.

Types d’intervalles pris en charge :

NANOSECOND
MICROSECOND
MILLISECOND
SECOND
MINUTE
HOUR
DAY
WEEK
MONTH
QUARTER
YEAR

Pour chaque type d’intervalle, il existe un type de données distinct. Par exemple, l’intervalle DAY correspond au type de données IntervalDay :

SELECT toTypeName(INTERVAL 4 DAY)

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

Remarques d’utilisation

Vous pouvez utiliser des valeurs de type Interval dans des opérations arithmétiques avec des valeurs de type Date et DateTime. Par exemple, vous pouvez ajouter 4 jours à l’instant actuel :

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

Il est également possible d’utiliser plusieurs intervalles simultanément :

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

Et pour comparer des valeurs avec des intervalles différents :

SELECT toIntervalMicrosecond(179999999) < toIntervalMinute(3);

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

SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);

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

Agrégation

Appliquées à une colonne Interval, les fonctions sum, avg, min, max et any renvoient un intervalle du même type. sum additionne le nombre d’unités, tandis que avg en calcule la moyenne et arrondit le résultat à un nombre entier d’unités :

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

Les valeurs exprimées dans des unités différentes sont converties dans leur unité commune avant d’être agrégées ; ainsi, la somme d’une minute et d’une seconde donne 61 secondes. Month, Quarter et Year n’ont aucune unité commune avec les unités plus petites (un mois ne compte pas un nombre fixe de jours) et ne peuvent donc en aucun cas être combinées avec elles.

Intervalles de type mixte

Les intervalles de type mixte, par exemple avec plusieurs heures et plusieurs minutes, peuvent être créés à l’aide de la syntaxe INTERVAL 'value' <from_kind> TO <to_kind>. Le résultat est un tuple de deux intervalles ou plus. Combinaisons prises en charge :

Syntaxe	Format de la chaîne	Exemple
`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`

Les champs autres que le premier sont validés conformément à la norme 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 signe + ou - facultatif en début de valeur s’applique à tous les composants :

SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;

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

Voir aussi

opérateur INTERVAL
fonctions de conversion de type toInterval
fonction d’agrégation avg
fonction d’agrégation sum

Référence SQL

Types de données

Moteurs

Fonctions

Formats

Paramètres

Tables système

Lacs de données

Remarques d’utilisation

Agrégation

Intervalles de type mixte

Voir aussi

​Remarques d’utilisation

​Agrégation

​Intervalles de type mixte

​Voir aussi

Remarques d’utilisation

Agrégation

Intervalles de type mixte

Voir aussi