range()

Gera uma matriz dinâmica que contém uma série de valores espaçados igualmente.

Syntax

range(Começar,parar [,etapa])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
start	escalar	✔️	O valor do primeiro elemento na matriz resultante.
stop	escalar	✔️	O valor máximo do último elemento na matriz resultante, de modo que o último valor na série seja menor ou igual ao valor de parada.
step	escalar		A diferença entre dois elementos consecutivos da matriz. O valor padrão da etapa é 1 para numérico e 1h para timespan ou datetime.

Retornos

Uma matriz dinâmica cujos valores são: iniciar, iniciar + etapa, ... até e incluindo parar. A matriz será truncada se o número máximo de resultados permitidos for atingido.

Observação

A função de intervalo dá suporte a um máximo de 1.048.576 (2^20) resultados.

Exemplos

O exemplo a seguir retorna uma matriz de números de um a oito, com um incremento de três.

Executar a consulta

print r = range(1, 8, 3)

Saída

r
[1,4,7]

O exemplo a seguir retorna uma matriz com todas as datas do ano de 2007.

Executar a consulta

print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)

Saída

r
["2007-01-01T00:00:00.0000000Z","2007-01-02T00:00:00.00000000Z","2007-01-03T00:00:00.0000000Z",.....,"2007-12-31T00:00:00.00000000Z"]

O exemplo a seguir retorna uma matriz com números entre um e três.

Executar a consulta

print range(1, 3)

Saída

print_0
[1,2,3]

O exemplo a seguir retorna um intervalo de horas entre uma hora e cinco horas.

Executar a consulta

print range(1h, 5h)

Saída

print_0
1\.000.000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

O exemplo a seguir retorna uma matriz truncada, pois o intervalo excede o limite máximo de resultados. O exemplo demonstra que o limite é excedido usando o operador mv-expand para expandir a matriz em vários registros e, em seguida, contar o número de registros.

Executar a consulta

print r = range(1,1000000000) 
| mv-expand r 
| count

Saída

Contagem
1\.048.576