# Date.add

## 功能

返回加减指定时间后的新 Date 对象。

## 语法

```bt
date_value.add(amount, unit)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| amount | Number | 是 | 无 | 加减数量；负数表示减。 |
| unit | String | 否 | seconds | 单位。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Date | 新 Date 对象。 |

## 代码示例

```bt
result = date('2026-01-01 00:00:00').add(1, 'days').to_string()

// 输出：2026-01-02 00:00:00

print result
```

## 注意事项

- 支持单位：millis、seconds、minutes、hours、days、weeks、months、years。
- 不修改原 Date 对象。