# 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` | 02 |
| 日 | `2012-02-22 00:00:00` | 22 |
| 小时 | `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` |