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

# Funzione DATE\$1ADD in Amazon QLDB
<a name="ql-functions.date_add"></a>

**Importante**  
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

In Amazon QLDB, usa `DATE_ADD` la funzione per incrementare un determinato valore di timestamp in base a un intervallo specificato.

## Sintassi
<a name="ql-functions.date_add.syntax"></a>

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

## Argomenti
<a name="ql-functions.date_add.arguments"></a>

*datetimepart*  
La parte relativa alla data o all'ora in cui opera la funzione. Questo parametro può essere uno dei seguenti:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
Il numero intero che specifica l'intervallo da aggiungere al dato. *timestamp* Un intero negativo sottrae l'intervallo.

*timestamp*  
Il nome di campo o l'espressione del tipo di dati `timestamp` che la funzione incrementa.  
Un valore letterale del timestamp di Ion può essere indicato con backticks (). ``...`` Per dettagli sulla formattazione ed esempi di valori di timestamp, consulta [Timestamp](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) nel documento delle specifiche di Amazon Ion.

## Tipo restituito
<a name="ql-functions.date_add.return-type"></a>

`timestamp`

## Esempi
<a name="ql-functions.date_add.examples"></a>

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

## Funzioni correlate
<a name="ql-functions.date_add.related"></a>
+ [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)