Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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 ADD\$1MONTHS
<a name="r_ADD_MONTHS"></a>

ADD\$1MONTHS ajoute le nombre de mois spécifié à une date, à une valeur d’horodatage ou à une expression. La fonction [DATEADD](r_DATEADD_function.md) fournit une fonctionnalité similaire. 

## Syntaxe
<a name="r_ADD_MONTHS-synopsis"></a>

```
ADD_MONTHS( {date | timestamp}, integer)
```

## Arguments
<a name="r_ADD_MONTHS-arguments"></a>

 *date* \$1 *timestamp*   
Colonne de type de données `DATE` ou `TIMESTAMP` ou expression implicitement évaluée à un type `DATE` ou `TIMESTAMP`. Si la date est le dernier jour du mois, ou si le mois résultant est plus court, la fonction renvoie le dernier jour du mois dans le résultat. Pour les autres dates, le résultat contient le même nombre de jours que l’expression de date. 

 *integer*   
Valeur du type de données `INTEGER`. Utilisez un nombre négatif pour soustraire des mois à partir de dates. 

## Type de retour
<a name="r_ADD_MONTHS-return-type"></a>

TIMESTAMP

## Exemples
<a name="r_ADD_MONTHS-example"></a>

La requête suivante utilise la fonction ADD\$1MONTHS à l’intérieur d’une fonction TRUNC. La fonction TRUNC supprime l’heure du jour des résultats de ADD\$1MONTHS. La fonction ADD\$1MONTHS ajoute 12 mois à chaque valeur de la colonne CALDATE. Les valeurs de la colonne CALDATE sont des dates. 

```
select distinct trunc(add_months(caldate, 12)) as calplus12,
trunc(caldate) as cal
from date
order by 1 asc;

 calplus12  |    cal
------------+------------
 2009-01-01 | 2008-01-01
 2009-01-02 | 2008-01-02
 2009-01-03 | 2008-01-03
...
(365 rows)
```

L’exemple suivant utilise la fonction ADD\$1MONTHS pour ajouter un mois à un *timestamp* (horodatage). 

```
select add_months('2008-01-01 05:07:30', 1); 

add_months
---------------------
2008-02-01 05:07:30
```

Les exemples suivants illustrent le comportement lorsque la fonction ADD\$1MONTHS opère sur des dates comportant des mois avec un nombre de jours différent. Cet exemple montre comment la fonction procède pour ajouter un mois au 31 mars et un mois au 30 avril. Sachant que le mois d’avril compte 30 jours, l’ajout d’un mois au 31 mars donne en résultat le 30 avril. En revanche, comme le mois de mai compte 31 jours, l’ajout d’un mois au 30 avril a pour résultat le 31 mai. 

```
select add_months('2008-03-31',1);

add_months
---------------------
2008-04-30 00:00:00

select add_months('2008-04-30',1); 

add_months
---------------------
2008-05-31 00:00:00
```