Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

`addDateTime` aggiunge o sottrae un'unità di tempo a o da un valore datetime. Ad esempio, `addDateTime(2,'YYYY',parseDate('02-JUL-2018', 'dd-MMM-yyyy') )` restituisce `02-JUL-2020`. È possibile utilizzare questa funzione per eseguire la matematica delle date sui dati di data e ora. 

## Sintassi
<a name="addDateTime-function-syntax"></a>

```
addDateTime(amount, period, datetime)
```

## Arguments (Argomenti)
<a name="addDateTime-function-arguments"></a>

 *amount*   
Un valore intero positivo o negativo che rappresenta la quantità di tempo che si desidera aggiungere o sottrarre dal campo di datetime fornito. 

 *punto*   
Un valore positivo o negativo che rappresenta la quantità di tempo che si desidera aggiungere o sottrarre dal campo di datetime fornito. I periodi validi sono:   
+ YYYY: restituisce la porzione dell'anno della data. 
+ Q: restituisce il trimestre di cui fa parte la data (1-4). 
+ MM: restituisce la porzione del mese della data. 
+ DD: restituisce la porzione del giorno della data. 
+ WK: restituisce la porzione della settimana della data. La settimana inizia di domenica in Amazon Quick. 
+ HH: restituisce la porzione dell'ora della data. 
+ MI: restituisce la porzione dei minuti della data. 
+ SS: restituisce la porzione dei secondi della data
+ MS: restituisce la porzione dei millisecondi della data.

 *datetime*   
La data o l'ora su cui si desidera eseguire la matematica delle date. 

## Tipo restituito
<a name="addDateTime-function-return-type"></a>

Datetime

## Esempio
<a name="addDateTime-function-example"></a>

Supponiamo di disporre di un campo denominato `purchase_date` che ha i seguenti valori.

```
2018 May 13 13:24
2017 Jan 31 23:06
2016 Dec 28 06:45
```

Utilizzando i seguenti calcoli, `addDateTime` modifica i valori come mostrato di seguito.

```
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
```