# DATE\_DIFF

計算兩個時間戳記之間的差異。

## 語法

```
DATE_DIFF(UNIT, TIMESTAMP1, TIMESTAMP2)
```

## 引數

#### UNIT

類型：`string`

要傳回的時間單位。

這可以是下列內容之一：

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

#### TIMESTAMP1

類型： `timestamp`

要從 `TIMESTAMP2` 減去的時間。

#### TIMESTAMP2

類型： `timestamp`

從中減去 `TIMESTAMP1` 的時間。

## 傳回

類型：`bigint`

`TIME2 - TIME1` 以 `UNIT` 表示

***

## 範例

| UNIT | TIMESTAMP1 | TIMESTAMP2 | 輸出 |
| --- | --- | --- | --- |
| 日 | `2001-08-22 03:04:05.321` | `2001-08-23 03:04:05.321` | 1 |
| 年 | `2001-08-22 03:04:05.321` | `2006-08-22 03:04:05.321` | 5 |
| 年 | `2006-08-22 03:04:05.321'` | `2001-08-22 03:04:05.321` | -5 |
| second | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:35.321` | 30 |
| 季 | `2001-08-22 03:04:05.321` | `2001-11-22 03:04:05.321` | 1 |
| 季 | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:05.321` | 0 |
| 年 | `2001-08-22 03:04:05.321` | `null` | `null` |