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á.

# truncDate
<a name="truncDate-function"></a>

`truncDate` retorna um valor de data que representa uma parte especificada de uma data. Por exemplo, solicitar a parte do ano do valor 2012-09-02T00:00:00.000Z retorna 2012-01-01T00:00:00.000Z. Especificar um período de horas para uma data que não contenha informações de hora retorna o valor de data inicial inalterado.

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

```
truncDate('period', date)
```

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

 *período*   
O período da data em que você deseja retornar. Os períodos válidos são:  
+ AAAA: retorna a parte do ano da data.
+ P: Isso retorna a data do primeiro dia do trimestre ao qual a data pertence. 
+ MM: Isto retorna a parte do mês da data.
+ DD: retorna a parte do dia da data.
+ WK: retorna a parte da semana da data. A semana começa no domingo no Amazon Quick.
+ 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.

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

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

Data

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

O exemplo a seguir retorna uma data que representa o mês da data do pedido.

```
truncDate('MM', orderDate)
```

A seguir estão os valores de campo especificados.

```
orderDate      
=========
2012-12-14T00:00:00.000Z  
2013-12-29T00:00:00.000Z
2012-11-15T00:00:00.000Z
```

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

```
2012-12-01T00:00:00.000Z
2013-12-01T00:00:00.000Z
2012-11-01T00:00:00.000Z
```