Compartilhar via

range()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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

Sintaxe

range(start, stop [, passo])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
start scalar ✔️ O valor do primeiro elemento na matriz resultante.
stop scalar ✔️ O valor máximo do último elemento na matriz resultante, de modo que o último valor da 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 para step é 1 para numeric e 1h for timespan ou datetime.

Devoluções

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

Observação

A função de intervalo suporta 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.

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.

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.0000000Z","2007-01-03T00:00:00.0000000Z",.....,"2007-12-31T00:00:00.0000000Z"]

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

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.

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 à medida que 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, contando o número de registros.

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

Saída

Count
1\.048.576