> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Calcule la fonction PromQL `quantile_over_time` sur une grille temporelle régulière.
# timeSeriesQuantileToGrid
timeSeriesQuantileToGrid
Introduit dans : v26.9.0
Fonction d'agrégation qui prend en entrée des données de séries temporelles sous forme de paires timestamp/valeur et calcule la fonction [PromQL `quantile_over_time`](https://prometheus.io/docs/prometheus/latest/querying/functions/#quantile_over_time) sur une grille temporelle régulière définie par un timestamp de début, un timestamp de fin et un pas. Pour chaque point de la grille, les échantillons utilisés pour calculer le quantile sont ceux compris dans la fenêtre temporelle spécifiée. Le quantile est calculé selon la méthode R-7 (inclusive), comme pour `quantileExactInclusive`. Contrairement à `quantileExactInclusive`, les échantillons NaN ne sont pas ignorés : comme dans Prometheus, ils sont conservés et placés avant toute valeur réelle lors du tri. Ainsi, la médiane d'une fenêtre `[1, NaN, 2]` vaut `1`, et une fenêtre dont tous les échantillons sont NaN renvoie NaN.
Le niveau de quantile est passé en dernier argument, après les échantillons : soit un nombre unique utilisé pour tous les points de la grille, soit un tableau contenant un nombre par point de la grille. Il doit être identique pour toutes les lignes. Comme dans Prometheus, un niveau inférieur à 0 renvoie `-Inf`, un niveau supérieur à 1 renvoie `+Inf` et un niveau NaN renvoie NaN pour chaque point de la grille dont la fenêtre contient des échantillons.
Cette fonction est en aperçu privé ; activez-la en définissant `enable_time_series_aggregate_functions=true`.
**Syntaxe**
```sql theme={null}
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(timestamp, value, phi)
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(samples, phi)
```
**Paramètres**
* `start_timestamp` — Indique le début de la grille. Il peut également s'agir d'un nombre fractionnaire, ou d'une string contenant un nombre ou une date-heure au format texte. [`UInt32`](/fr/reference/data-types/int-uint) ou [`DateTime`](/fr/reference/data-types/datetime) ou [`DateTime64`](/fr/reference/data-types/datetime64) ou [`Float*`](/fr/reference/data-types/float) ou [`Decimal*`](/fr/reference/data-types/decimal) ou [`String`](/fr/reference/data-types/string)
* `end_timestamp` — Indique la fin de la grille. Il peut également s'agir d'un nombre fractionnaire, ou d'une string contenant un nombre ou une date-heure au format texte. [`UInt32`](/fr/reference/data-types/int-uint) ou [`DateTime`](/fr/reference/data-types/datetime) ou [`DateTime64`](/fr/reference/data-types/datetime64) ou [`Float*`](/fr/reference/data-types/float) ou [`Decimal*`](/fr/reference/data-types/decimal) ou [`String`](/fr/reference/data-types/string)
* `grid_step` — Indique le pas de la grille, en secondes. Il peut également s'agir d'un nombre fractionnaire, ou d'une string contenant un nombre ou une durée telle que '15s' ou '1m'. [`UInt32`](/fr/reference/data-types/int-uint) ou [`Float*`](/fr/reference/data-types/float) ou [`Decimal*`](/fr/reference/data-types/decimal) ou [`String`](/fr/reference/data-types/string)
* `staleness` — Indique l'ancienneté maximale (« staleness »), en secondes, des échantillons pris en compte. La fenêtre d'ancienneté est un intervalle ouvert à gauche et fermé à droite. Il peut également s'agir d'un nombre fractionnaire, ou d'une string contenant un nombre ou une durée telle que '15s' ou '1m'. [`UInt32`](/fr/reference/data-types/int-uint) ou [`Float*`](/fr/reference/data-types/float) ou [`Decimal*`](/fr/reference/data-types/decimal) ou [`String`](/fr/reference/data-types/string)
**Arguments**
* `timestamp` — Timestamp de l'échantillon. Il peut s'agir de valeurs individuelles ou de tableaux. [`UInt32`](/fr/reference/data-types/int-uint) ou [`DateTime`](/fr/reference/data-types/datetime) ou [`DateTime64`](/fr/reference/data-types/datetime64) ou [`Array(UInt32)`](/fr/reference/data-types/array) ou [`Array(DateTime)`](/fr/reference/data-types/array) ou [`Array(DateTime64)`](/fr/reference/data-types/array)
* `value` — Valeur de la série temporelle correspondant au timestamp. Il peut s'agir de valeurs individuelles ou de tableaux. [`Float*`](/fr/reference/data-types/float) ou [`Array(Float*)`](/fr/reference/data-types/array)
* `samples` — Échantillons de la série temporelle transmis sous forme de tableau de tuples `(timestamp, value)`, dont les éléments ont les types de timestamp et de valeur indiqués ci-dessus. Permet de ne pas transmettre les timestamps et les valeurs sous forme de deux arguments distincts. [`Array(Tuple(T1, T2))`](/fr/reference/data-types/array)
* `phi` — Niveau de quantile, normalement compris dans la plage \[0, 1] : soit un seul nombre pour l'ensemble de la grille, soit un tableau contenant un nombre par point de la grille. Doit être identique pour toutes les lignes. [`Float*`](/fr/reference/data-types/float) ou [`UInt8/16/32/64`](/fr/reference/data-types/int-uint) ou [`Int8/16/32/64`](/fr/reference/data-types/int-uint) ou [`Array(Float*)`](/fr/reference/data-types/array) ou [`Array(UInt8/16/32/64)`](/fr/reference/data-types/array) ou [`Array(Int8/16/32/64)`](/fr/reference/data-types/array)
**Valeur renvoyée**
Renvoie le quantile phi des valeurs sur la grille spécifiée. Le tableau renvoyé contient une valeur pour chaque point de la grille temporelle. La valeur est NULL si aucun échantillon ne se trouve dans la fenêtre d'un point de grille donné. [`Array(Nullable(Float64))`](/fr/reference/data-types/array)
**Exemples**