As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Extract
<a name="extract-function"></a>

`extract` retorna uma parte especificada de um valor de data. Solicitar uma parte de uma data relacionada a tempo que não contém informações de tempo retorna 0.

## Sintaxe
<a name="extract-function-syntax"></a>

```
extract(period, date)
```

## Argumentos
<a name="extract-function-arguments"></a>

 *período*   
O período que você deseja extrair do valor de data. Os períodos válidos são:  
+ AAAA: retorna a parte do ano da data.
+ Q: isso retorna o trimestre ao qual a data pertence (de 1 a 4). 
+ MM: Isto retorna a parte do mês da data.
+ DD: retorna a parte do dia da data.
+ WD: retorna o dia da semana como número inteiro, com domingo sendo 1.
+ HH: retorna a parte da hora da data.
+ MI: Isto retorna a parte do minuto da data.
+ SS: Isto retorna a parte do segundo da data.
+ MS: isso retorna a parte do milissegundo da data.
**nota**  
A extração de milissegundos não tem suporte dos bancos de dados do Presto anteriores à versão 0.216.

 *data*   
Um campo de data ou uma chamada para outra função que gera uma data.

## Tipo de retorno
<a name="extract-function-return-type"></a>

Inteiro

## Exemplo
<a name="extract-function-example"></a>

O exemplo a seguir extrai o dia de um valor de data.

```
extract('DD', orderDate)
```

A seguir estão os valores de campo especificados.

```
orderDate
=========
01/01/14  
09/13/16
```

Para esses valores de campo, os seguintes valores são retornados.

```
01
13
```