# DATE\_DIFF

2 つのタイムスタンプの差を計算します。

## 構文

```
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 | 出力 |
| --- | --- | --- | --- |
| day | `2001-08-22 03:04:05.321` | `2001-08-23 03:04:05.321` | 1 |
| year | `2001-08-22 03:04:05.321` | `2006-08-22 03:04:05.321` | 5 |
| year | `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 |
| quarter | `2001-08-22 03:04:05.321` | `2001-11-22 03:04:05.321` | 1 |
| quarter | `2001-08-22 03:04:05.321` | `2001-08-22 03:04:05.321` | 0 |
| year | `2001-08-22 03:04:05.321` | `null` | `null` |