# EXTRACT

Extrai uma unidade de tempo como um campo do carimbo de data/hora fornecido.

## Sintaxe

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

## Argumentos

#### FIELD

Tipo: `identifier`

A unidade de tempo para extração.

Os seguintes campos são suportados:

| Campo | Descrição |
| --- | --- |
| `YEAR` | ano |
| `QUARTER` | trimestre |
| `MONTH` | mês |
| `WEEK` | semana |
| `DAY` | dia |
| `DAY_OF_MONTH` | dia |
| `DAY_OF_WEEK` | dia da semana |
| `DOW` | dia da semana |
| `DAY_OF_YEAR` | dia do ano |
| `DOY` | dia do ano |
| `YEAR_OF_WEEK` | ano da semana |
| `YOW` | ano da semana |
| `HOUR` | hora |
| `MINUTE` | minute |
| `SECOND` | second |

#### X

Tipo: `timestamp`

A hora a partir da qual extrair `FIELD` .

## Retorna

Tipo: `bigint`

O `FIELD` extraído de `X`.

***

## Exemplos

| Campo | X | Saída |
| --- | --- | --- |
| ano | `2012-02-22 00:00:00` | 2012 |
| mês | `2012-02-22 00:00:00` | 02 |
| dia | `2012-02-22 00:00:00` | 22 |
| hora | `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` |