> ## 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.
> Calcula `quantile_over_time` de PromQL en una cuadrícula temporal regular.
# timeSeriesQuantileToGrid
timeSeriesQuantileToGrid
Introducido en: v26.9.0
Función de agregación que recibe datos de series temporales como pares de marcas de tiempo y valores, y calcula la función [PromQL `quantile_over_time`](https://prometheus.io/docs/prometheus/latest/querying/functions/#quantile_over_time) sobre una cuadrícula temporal regular definida por una marca de tiempo de inicio, una marca de tiempo de fin y un paso. Para cada punto de la cuadrícula, las muestras que se usan para calcular el cuantil son las que se encuentran dentro de la ventana de tiempo especificada. El cuantil se calcula mediante el método R-7 (inclusivo), igual que `quantileExactInclusive`. A diferencia de `quantileExactInclusive`, las muestras NaN no se omiten: al igual que en Prometheus, se conservan y se ordenan antes de cualquier valor real, de modo que una ventana `[1, NaN, 2]` tiene mediana `1`, y una ventana cuyas muestras son todas NaN devuelve NaN.
El nivel del cuantil se pasa después de las muestras, como último argumento: puede ser un único número que se aplica a todos los puntos de la cuadrícula o un array con un número por cada punto de la cuadrícula. Debe ser el mismo en todas las filas. Al igual que en Prometheus, un nivel inferior a 0 devuelve `-Inf`, un nivel superior a 1 devuelve `+Inf` y un nivel NaN devuelve NaN en todos los puntos de la cuadrícula cuya ventana contenga muestras.
Esta función está en vista previa privada; para habilitarla, configure `enable_time_series_aggregate_functions=true`.
**Sintaxis**
```sql theme={null}
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(timestamp, value, phi)
timeSeriesQuantileToGrid(start_timestamp, end_timestamp, grid_step, staleness)(samples, phi)
```
**Parámetros**
* `start_timestamp` — Especifica el inicio de la cuadrícula. También puede ser un número fraccionario o una cadena que contenga un número o un texto de fecha y hora. [`UInt32`](/es/reference/data-types/int-uint) o [`DateTime`](/es/reference/data-types/datetime) o [`DateTime64`](/es/reference/data-types/datetime64) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal) o [`String`](/es/reference/data-types/string)
* `end_timestamp` — Especifica el final de la cuadrícula. También puede ser un número fraccionario o una cadena que contenga un número o un texto de fecha y hora. [`UInt32`](/es/reference/data-types/int-uint) o [`DateTime`](/es/reference/data-types/datetime) o [`DateTime64`](/es/reference/data-types/datetime64) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal) o [`String`](/es/reference/data-types/string)
* `grid_step` — Especifica el paso de la cuadrícula en segundos. También puede ser un número fraccionario o una cadena que contenga un número o una duración, como '15s' o '1m'. [`UInt32`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal) o [`String`](/es/reference/data-types/string)
* `staleness` — Especifica la "antigüedad" máxima, en segundos, de las muestras consideradas. La ventana de antigüedad es un intervalo abierto por la izquierda y cerrado por la derecha. También puede ser un número fraccionario o una cadena que contenga un número o una duración, como '15s' o '1m'. [`UInt32`](/es/reference/data-types/int-uint) o [`Float*`](/es/reference/data-types/float) o [`Decimal*`](/es/reference/data-types/decimal) o [`String`](/es/reference/data-types/string)
**Argumentos**
* `timestamp` — Marca de tiempo de la muestra. Puede ser un valor individual o un array. [`UInt32`](/es/reference/data-types/int-uint) o [`DateTime`](/es/reference/data-types/datetime) o [`DateTime64`](/es/reference/data-types/datetime64) o [`Array(UInt32)`](/es/reference/data-types/array) o [`Array(DateTime)`](/es/reference/data-types/array) o [`Array(DateTime64)`](/es/reference/data-types/array)
* `value` — Valor de la serie temporal correspondiente a la marca de tiempo. Puede ser un valor individual o un array. [`Float*`](/es/reference/data-types/float) o [`Array(Float*)`](/es/reference/data-types/array)
* `samples` — Muestras de la serie temporal, pasadas como un array de tuplas `(timestamp, value)`, donde los elementos de la tupla tienen los tipos de marca de tiempo y valor indicados anteriormente. Es una alternativa a pasar las marcas de tiempo y los valores como dos argumentos independientes. [`Array(Tuple(T1, T2))`](/es/reference/data-types/array)
* `phi` — Nivel de cuantil, normalmente en el rango \[0, 1]: puede ser un único número para toda la cuadrícula o un array con un número por cada punto de la cuadrícula. Debe ser el mismo en todas las filas. [`Float*`](/es/reference/data-types/float) o [`UInt8/16/32/64`](/es/reference/data-types/int-uint) o [`Int8/16/32/64`](/es/reference/data-types/int-uint) o [`Array(Float*)`](/es/reference/data-types/array) o [`Array(UInt8/16/32/64)`](/es/reference/data-types/array) o [`Array(Int8/16/32/64)`](/es/reference/data-types/array)
**Valor devuelto**
Devuelve el cuantil phi de los valores en la cuadrícula especificada. El array devuelto contiene un valor por cada punto de la cuadrícula temporal. El valor es NULL si no hay muestras dentro de la ventana para un punto determinado de la cuadrícula. [`Array(Nullable(Float64))`](/es/reference/data-types/array)
**Ejemplos**