range()

產生包含一系列相等間距值的動態陣列。

Syntax

range(開始,stop [,step])

名稱	類型	必要	Description
開始	純量 (scalar)	✔️	結果陣列中第一個專案的值。
停止	純量 (scalar)	✔️	結果陣列中最後一個專案的最大值，使得數列中的最後一個值小於或等於停止值。
步	純量 (scalar)		陣列的兩個連續元素之間的差異。步驟的預設值是`1`針對數值和 `1htimespan` 或 `datetime`。

動態陣列，其值為： start、 start + step、 ...最多和包含停止。如果達到允許的結果數目上限，則會截斷陣列。

注意

範圍函式最多支援 1,048,576 (2^20 個) 結果。

下列範例會傳回數位數位數位數組，從一到八，遞增為三。

print r = range(1, 8, 3)

輸出

r
[1,4,7]

下列範例會傳回陣列，其中包含 2007 年的所有日期。

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

輸出

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”]

下列範例會傳回一到三之間的數字數位數位數位。

print range(1, 3)

輸出

print_0
[1,2,3]

下列範例會傳回介於一小時到五小時之間的小時範圍。

print range(1h, 5h)

輸出

print_0
1,000,000
`["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]`:

下列範例會傳回截斷數位，因為範圍超過結果上限。此範例示範使用 mv-expand 運算子將陣列展開成多個記錄，然後計算記錄數目，來超過限制。

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

輸出

Count
1,048,576