你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

range()

生成包含一系列等间距值的动态数组。

语法

range(start,stop [,step])

名称	类型	必需	说明
start	标量 (scalar)	✔️	生成数组中第一个元素的值。
stop	标量 (scalar)	✔️	结果数组中最后一个元素的最大值，使得序列中的最后一个值小于或等于停止值。
step	标量 (scalar)		数组中两个连续元素之间的差异。 step 的默认值为 `1`（对于数字）和 `1h`（对于 `timespan` 或 `datetime`）。

动态数组，其值为：start、start + step...直至并包括 stop。如果达到允许的最大结果数，数组将被截断。

注意

range 函数最多支持 1,048,576 (2^20) 结果。

以下示例返回一个从 1 到 8 的数字数组，增量为 3。

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”，“20 07-01-03T00：00：00.0000000Z”,.....,“2007-12-31T00：00：00.0000000Z”]

以下示例返回一个数组，其数字介于 1 和 3 之间。

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