Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

**Important**  
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez [Migrer un registre Amazon QLDB vers Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).

Dans Amazon QLDB, utilisez `DATE_ADD` la fonction pour incrémenter une valeur d'horodatage donnée selon un intervalle spécifié.

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

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

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

*datetimepart*  
Partie de date ou d'heure sur laquelle la fonction fonctionne. Ce paramètre peut avoir l'une des valeurs suivantes :  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*interval*  
Le nombre entier qui indique l'intervalle à ajouter à l'intervalle donné*timestamp*. Un nombre entier négatif soustrait l’intervalle.

*timestamp*  
Nom du champ ou expression du type de données `timestamp` que la fonction incrémente.  
Une valeur littérale d'horodatage ionique peut être indiquée par backticks (). ``...`` Pour obtenir des informations sur le formatage et des exemples de valeurs d'horodatage, consultez la section [Horodatages du document](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) de spécification Amazon Ion.

## Type de retour
<a name="ql-functions.date_add.return-type"></a>

`timestamp`

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

## Fonctions associées
<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)