# EXTRACT

指定されたタイムスタンプから、時間の単位を項目として抽出します。

## 構文

```
EXTRACT(FIELD FROM X)
```

## 引数

#### FIELD

型: `identifier`

抽出する時間の単位。

次の項目がサポートされています。

| 項目 | 説明 |
| --- | --- |
| `YEAR` | 年 |
| `QUARTER` | 四半期 |
| `MONTH` | 月 |
| `WEEK` | 週 |
| `DAY` | 日 |
| `DAY_OF_MONTH` | 日 |
| `DAY_OF_WEEK` | 週の日 |
| `DOW` | 週の日 |
| `DAY_OF_YEAR` | 年の日 |
| `DOY` | 年の日 |
| `YEAR_OF_WEEK` | 週の年 |
| `YOW` | 週の年 |
| `HOUR` | 時間 |
| `MINUTE` | 分 |
| `SECOND` | 秒 |

#### X

型: `timestamp`

`FIELD` を抽出する対象となる時間。

## 戻り値

型: `bigint`

`X` から抽出された `FIELD`。

***

## 例

| 項目 | X | 出力 |
| --- | --- | --- |
| year | `2012-02-22 00:00:00` | 2012 |
| month | `2012-02-22 00:00:00` | 02 |
| day | `2012-02-22 00:00:00` | 22 |
| hour | `2012-02-22 00:00:00` | 01 |
| minute | `2012-02-22 01:02:00` | 02 |
| second | `2012-02-22 01:00:32` | 21 |
| dow | `2012-02-22 01:00:32` | 3 |
| dow | `null` | `null` |