range()

Generiert ein dynamisches Array mit einer Reihe gleichmäßig verteilter Werte.

Syntax

range(Startstopp, [, Schritt])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
start	Skalar	✔️	Der Wert des ersten Elements im resultierenden Array.
stop	Skalarwert	✔️	Der Maximalwert des letzten Elements im resultierenden Array, sodass der letzte Wert in der Datenreihe kleiner oder gleich dem Stoppwert ist.
Schritt	Skalar		Der Unterschied zwischen zwei aufeinander folgenden Elementen des Arrays. Der Standardwert für Schritt ist für numerisch und 1h für timespan oder datetime.1

Gibt zurück

Ein dynamisches Array, dessen Werte sind: Start, Startschritt + , ... bis zu und einschließlich Stopp. Das Array wird abgeschnitten, wenn die maximale Anzahl zulässiger Ergebnisse erreicht ist.

Hinweis

Die Bereichsfunktion unterstützt maximal 1.048.576 (2^20) Ergebnisse.

Beispiele

Das folgende Beispiel gibt ein Array von Zahlen von 1 bis acht zurück, wobei ein Inkrement von drei erhöht wird.

Abfrage ausführen

print r = range(1, 8, 3)

Output

r
[1,4,7]

Im folgenden Beispiel wird ein Array mit allen Datumsangaben aus dem Jahr 2007 zurückgegeben.

Abfrage ausführen

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

Output

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

Im folgenden Beispiel wird ein Array mit Zahlen zwischen 1 und drei zurückgegeben.

Abfrage ausführen

print range(1, 3)

Output

print_0
[1,2,3]

Im folgenden Beispiel wird ein Stundenbereich zwischen einer Stunde und fünf Stunden zurückgegeben.

Abfrage ausführen

print range(1h, 5h)

Output

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

Im folgenden Beispiel wird ein abgeschnittenes Array zurückgegeben, da der Bereich die maximale Ergebnisgrenze überschreitet. Das Beispiel zeigt, dass der Grenzwert überschritten wird, indem der mv-expand-Operator verwendet wird, um das Array in mehrere Datensätze zu erweitern und dann die Anzahl der Datensätze zu zählen.

Abfrage ausführen

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

Output

Anzahl
1.048.576