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

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

`dateDiff` retorna a diferença de dias entre dois campos de data. Se você incluir um valor para o período, `dateDiff` retorna a diferença no intervalo do período, em vez de em dias.

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

```
dateDiff(date1, date2,[period])
```

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

`dateDiff` leva duas datas como argumentos. Especificar um período é opcional.

 *data 1*   
A primeira data na comparação. Um campo de data ou uma chamada para outra função que gera uma data. 

 *data 2*   
A segunda data na comparação. Um campo de data ou uma chamada para outra função que gera uma data. 

 *período*   
O período de diferença que você quer que retorne, entre aspas. 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.

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

Inteiro

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

O exemplo a seguir retorna a diferença entre duas datas.

```
dateDiff(orderDate, shipDate, "MM")
```

A seguir estão os valores de campo especificados.

```
orderDate          shipdate
=============================
01/01/18            03/05/18
09/13/17            10/20/17
```

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

```
2
1
```