

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

`addDateTime` suma o resta una unidad de tiempo a partir de valor de fecha y hora. Por ejemplo, `addDateTime(2,'YYYY',parseDate('02-JUL-2018', 'dd-MMM-yyyy') )` devuelve `02-JUL-2020`. Puede utilizar esta función para realizar cálculos de fecha en los datos de fecha y hora. 

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

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

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

 *amount*   
Un valor entero positivo o negativo que representa la cantidad de tiempo que desea sumar o restar en el campo de fecha y hora proporcionado. 

 *periodo*   
Un valor positivo o negativo que representa la cantidad de tiempo que desea sumar o restar del campo de fecha y hora proporcionado. Los periodos válidos son los siguientes:   
+ YYYY: devuelve la parte del año de la fecha. 
+ Q: devuelve el trimestre al que pertenece la fecha (1 a 4). 
+ MM: devuelve la parte del mes de la fecha. 
+ DD: devuelve la parte del día de la fecha. 
+ WK: devuelve la parte de la semana de la fecha. La semana comienza el domingo en Amazon Quick. 
+ HH: devuelve la parte de la hora de la fecha. 
+ MI: devuelve la parte de minutos de la fecha. 
+ SS: devuelve la parte de segundos de la fecha.
+ MS: devuelve la parte de milisegundos de la fecha.

 *datetime*   
La fecha u hora en la que desea realizar cálculos de fecha. 

## Tipo de devolución
<a name="addDateTime-function-return-type"></a>

Fecha y hora

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

Supongamos que tiene un campo llamado `purchase_date` que tiene los siguientes valores.

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

Con los siguientes cálculos, `addDateTime` modifica los valores tal y como se muestra a continuación.

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