> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation du type de données spécial Interval

# 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](/fr/reference/operators/index#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` :

```sql theme={null}
SELECT toTypeName(INTERVAL 4 DAY)
```

```text theme={null}
┌─toTypeName(toIntervalDay(4))─┐
│ IntervalDay                  │
└──────────────────────────────┘
```

<div id="usage-remarks">
  ## Remarques d’utilisation
</div>

Vous pouvez utiliser des valeurs de type `Interval` dans des opérations arithmétiques avec des valeurs de type [Date](/fr/reference/data-types/date) et [DateTime](/fr/reference/data-types/datetime). Par exemple, vous pouvez ajouter 4 jours à l’instant actuel :

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + INTERVAL 4 DAY
```

```text theme={null}
┌───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 :

```sql theme={null}
SELECT now() AS current_date_time, current_date_time + (INTERVAL 4 DAY + INTERVAL 3 HOUR)
```

```text theme={null}
┌───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 :

```sql theme={null}
SELECT toIntervalMicrosecond(3600000000) = toIntervalHour(1);
```

```text theme={null}
┌─less(toIntervalMicrosecond(179999999), toIntervalMinute(3))─┐
│                                                           1 │
└─────────────────────────────────────────────────────────────┘
```

<div id="mixed-type-intervals">
  ## Intervalles de type mixte
</div>

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.

```sql theme={null}
SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

Un signe `+` ou `-` facultatif en début de valeur s’applique à tous les composants :

```sql theme={null}
SELECT INTERVAL '+1:30' HOUR TO MINUTE;
-- this is equivalent to:
-- SELECT INTERVAL '1:30' HOUR TO MINUTE;
```

```text theme={null}
┌─(toIntervalHour(1), toIntervalMinute(30))─┐
│ (1,30)                                     │
└────────────────────────────────────────────┘
```

<div id="see-also">
  ## Voir aussi
</div>

* opérateur [INTERVAL](/fr/reference/operators/index#interval)
* fonctions de conversion de type [toInterval](/fr/reference/functions/regular-functions/type-conversion-functions#toIntervalYear)