你当前正在访问 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 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈