# DATE\_ADD

將指定單位的間隔新增至給定的時間戳記。可以使用負間隔值執行減法。

## 語法

```
DATE_ADD(UNIT, VALUE, TIMESTAMP)
```

## 引數

#### UNIT

類型： `string`

要新增的時間單位。

這可以是下列內容之一：

* `year`
* `quarter`
* `month`
* `week`
* `day`
* `hour`
* `minute`
* `second`
* `millisecond`

#### VALUE

類型：`bigint`

`UNIT` 的整數值，要新增至 `TIMESTAMP`。

可以是正數 (表示未來時間) 或負數 (表示過去時間)。

#### TIMESTAMP

類型：`timestamp`

要修改的時間戳記。

## 傳回

類型： `timestamp`

已將指定的 `NUMBER` 的 `INTERVAL` 新增至 `TIMESTAMP`。

***

## 範例

| UNIT | 值 | 時間戳記 | 輸出 |
| --- | --- | --- | --- |
| 日 | 1 | `2001-08-22 03:04:05.321` | `2001-08-23 03:04:05.321` |
| 年 | 5 | `2001-08-22 03:04:05.321` | `2006-08-22 03:04:05.321` |
| second | 30 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:35.321` |
| 季 | 1 | `2001-08-22 03:04:05.321` | `2001-11-22 03:04:05.321` |
| 季 | -1 | `2001-08-22 03:04:05.321` | `2001-05-22 03:04:05.321` |
| 季 | 0 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:05.321` |
| 年 | 1 | `null` | `null` |