range()
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Genera una matriz dinámica que mantiene una serie de valores espaciados uniformemente.
Sintaxis
range(start, stop [, step])
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| start | escalares | ✔️ | Valor del primer elemento de la matriz resultante. |
| stop | escalares | ✔️ | Valor máximo del último elemento de la matriz resultante, de modo que el último valor de la serie sea menor o igual que el valor de detención. |
| step | escalar | Diferencia entre dos elementos consecutivos de la matriz. El valor predeterminado del paso es 1 para numérico y 1h para timespan o datetime. |
Devoluciones
Matriz dinámica cuyos valores son: start, start + step, ... hasta la parada y la inclusión. La matriz se trunca si se alcanza el número máximo de resultados permitidos.
Nota:
La función range admite un máximo de 1048 576 (2^20) resultados.
Ejemplos
En el ejemplo siguiente se devuelve una matriz de números de uno a ocho, con un incremento de tres.
print r = range(1, 8, 3)
Salida
| r |
|---|
| [1,4,7] |
En el ejemplo siguiente se devuelve una matriz con todas las fechas del año 2007.
print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)
Salida
| r |
|---|
| ["2007-01-01T00:00:00.000000Z","2007-01-02T00:00:00.000000Z","2007-01-03T00:00:00.0000000Z",.....,"2007-12-31T00:00:00.000000Z"] |
En el ejemplo siguiente se devuelve una matriz con números entre uno y tres.
print range(1, 3)
Salida
| print_0 |
|---|
| [1,2,3] |
En el ejemplo siguiente se devuelve un intervalo de horas entre una hora y cinco horas.
print range(1h, 5h)
Salida
| print_0 |
|---|
| 1 000 000 |
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]: |
En el ejemplo siguiente se devuelve una matriz truncada a medida que el intervalo supera el límite máximo de resultados. En el ejemplo se muestra que el límite se supera mediante el operador mv-expand para expandir la matriz en varios registros y, a continuación, contar el número de registros.
print r = range(1,1000000000)
| mv-expand r
| count
Salida
| Count |
|---|
| 1 048 576 |