# [AggregateCommand](AggregateCommand).range(value: [Expression](/minigame/dev/wxcloud/reference-sdk-api/database/aggregate/Expression)[]): Object

> 支持端：[小程序 2.7.4](/miniprogram/dev/framework/client-lib/version.md), [云函数 0.8.1](/minigame/dev/wxcloud/reference/changelog-server-sdk), [Web](/minigame/dev/wxcloud/reference/changelog-web-sdk)

聚合操作符。返回一组生成的序列数字。给定开始值、结束值、非零的步长，`range` 会返回从开始值开始逐步增长、步长为给定步长、但不包括结束值的序列。

## 参数

### value: [Expression](/minigame/dev/wxcloud/reference-sdk-api/database/aggregate/Expression)[]

[<start>, <end>, <non-zero step>]

## 返回值

### Object

## API 说明

语法如下：

```
db.command.aggregate.range([, , ])
```

| 字段 | 说明 |
| ------- | ---- |
| start | 开始值，一个可以解析为整形的表达式 |
| end    | 结束值，一个可以解析为整形的表达式 |
| non-zero step  | 可选，步长，一个可以解析为非零整形的表达式，默认为 1 |

## 示例代码

假设集合 `stats` 有如下记录：

```json
{ "_id": 1, "max": 52 }
{ "_id": 2, "max": 38 }
```

```js
const $ = db.command.aggregate
db.collection('stats').aggregate()
  .project({
    points: $.range([0, '$max', 10])
  })
  .end()
```

返回结果如下：

```json
{ "_id": 1, "points": [0, 10, 20, 30, 40, 50] }
{ "_id": 2, "points": [0, 10, 20] }
```