range()

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

Syntax

range(iniciar,parar [,passo])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

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

Devoluções

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

Nota

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

Exemplos

O exemplo seguinte devolve 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 seguinte devolve uma matriz com todas as datas do ano 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.0000000Z"]

O exemplo seguinte devolve 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 seguinte devolve 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 seguinte devolve uma matriz truncada, uma vez que o intervalo excede o limite máximo de resultados. O exemplo demonstra que o limite é excedido ao utilizar o operador mv-expand para expandir a matriz em múltiplos registos e, em seguida, contar o número de registos.

Executar a consulta

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

Saída

de palavras
1 048 576