# 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` | minute |
| `SECOND` | second |

#### X

類型： `timestamp`

要從中擷取 `FIELD` 的時間。

## 傳回

類型：`bigint`

從 `X` 中擷取的 `FIELD`。

***

## 範例

| 欄位 | X | 輸出 |
| --- | --- | --- |
| 年 | `2012-02-22 00:00:00` | 2012 |
| 月 | `2012-02-22 00:00:00` | 2 |
| 日 | `2012-02-22 00:00:00` | 22 |
| 小時 | `2012-02-22 00:00:00` | 1 |
| minute | `2012-02-22 01:02:00` | 2 |
| second | `2012-02-22 01:00:32` | 21 |
| dow | `2012-02-22 01:00:32` | 3 |
| dow | `null` | `null` |