

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.

# Función DATE\$1ADD en Amazon QLDB
DATE\$1ADD

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

En Amazon QLDB, use la función `DATE_ADD` para incrementar un valor de marca de tiempo determinado en un intervalo específico.

## Sintaxis


```
DATE_ADD( datetimepart, interval, timestamp )
```

## Argumentos


*datetimepart*  
La parte de la fecha o la hora sobre la que opera la función. Este parámetro puede ser uno de los siguientes:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
El número entero que especifica el intervalo que se va a añadir al intervalo dado. *timestamp* Un número entero negativo resta al intervalo.

*timestamp*  
El nombre de campo o la expresión del tipo de datos `timestamp` que incrementa la función.  
El valor literal de una marca de tiempo de Ion se puede indicar con comillas invertidas (``...``). Para obtener más detalles sobre formatos y ejemplos de valores de marcas de tiempo, consulte [Marcas de tiempo](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) en el documento de especificaciones de Amazon Ion.

## Tipo de retorno


`timestamp`

## Ejemplos


```
DATE_ADD(year, 5, `2010-01-01T`)                -- 2015-01-01T
DATE_ADD(month, 1, `2010T`)                     -- 2010-02T (result adds precision as necessary)
DATE_ADD(month, 13, `2010T`)                    -- 2011-02T (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_ADD(day, -1, `2017-01-10T`)                -- 2017-01-09T
DATE_ADD(hour, 1, `2017T`)                      -- 2017-01-01T01:00Z
DATE_ADD(hour, 1, `2017-01-02T03:04Z`)          -- 2017-01-02T04:04Z
DATE_ADD(minute, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:05:05.006Z
DATE_ADD(second, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:04:06.006Z

-- Runnable statements
SELECT DATE_ADD(year, 5, `2010-01-01T`) FROM << 0 >> -- 2015-01-01T
SELECT DATE_ADD(day, -1, `2017-01-10T`) FROM << 0 >> -- 2017-01-09T
```

## Funciones relacionadas

+ [DATE\$1DIFF](ql-functions.date_diff.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)
+ [UTCNOW](ql-functions.utcnow.md)