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á.
# addDateTime
`addDateTime` adiciona ou subtrai uma unidade de tempo de um valor de data e hora. Por exemplo, `addDateTime(2,'YYYY',parseDate('02-JUL-2018', 'dd-MMM-yyyy') )` exibe `02-JUL-2020`. Use essa função para realizar cálculos de data nos dados de data e hora.
## Sintaxe
```
addDateTime(amount, period, datetime)
```
## Argumentos
*amount*
Um valor inteiro positivo ou negativo que representa a quantidade de tempo que você deseja adicionar ou subtrair do campo datetime fornecido.
*período*
Um valor positivo ou negativo que representa a quantidade de tempo que deseja adicionar ou subtrair do campo datetime fornecido. 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.
+ 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.
*datetime*
A data ou hora em que deseja executar o cálculo de data.
## Tipo de retorno
Datetime
## Exemplo
Vamos supor que você tenha um campo chamado `purchase_date` com os valores a seguir.
```
2018 May 13 13:24
2017 Jan 31 23:06
2016 Dec 28 06:45
```
Usando os seguintes cálculos, `addDateTime` altera os valores conforme mostrado a seguir.
```
addDateTime(-2, 'YYYY', purchaseDate)
2016 May 13 13:24
2015 Jan 31 23:06
2014 Dec 28 06:45
addDateTime(4, 'DD', purchaseDate)
2018 May 17 13:24
2017 Feb 4 23:06
2017 Jan 1 06:45
addDateTime(20, 'MI', purchaseDate)
2018 May 13 13:44
2017 Jan 31 23:26
2016 Dec 28 07:05
```