range()
適用於:✅Microsoft網狀架構✅Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel
產生一個動態數位,其中包含一系列的相同間距值。
語法
range(
start,
stop [,
step])
深入瞭解 語法慣例。
參數
姓名 | 類型 | 必要 | 描述 |
---|---|---|---|
start | 純量 | ✔️ | 結果陣列中第一個專案的值。 |
停止 | 純量 | ✔️ | 結果陣列中最後一個專案的最大值,使得數列中的最後一個值小於或等於停止值。 |
步 | 純量 | 陣列的兩個連續元素之間的差異。 步驟的預設值是1 針對 numeric 和 1h for timespan 或 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.00000000Z”,“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] |
下列範例會傳回介於1小時到5小時之間的小時範圍。
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
輸出
計數 |
---|
1,048,576 |