ADD_MONTHS
Syntaxe
ADD_MONTHS(months, date_string [, input_format])
Paramètres
months
Entier représentant un nombre de mois à ajouter à date_string.
date_string
Chaîne de texte représentant une date valide, au format DELIM_M_D_Y ou au format spécifié par l'argument input_format facultatif.
input_format
Format à utiliser pour la date calculée. Pour une liste des formats de date pris en charge, voir la fonction DATE_FORMAT. Notez que input_format détermine le format de la chaîne en entrée, mais aussi de la chaîne en sortie.
Description
ADD_MONTHS renvoie une date après l'ajout du nombre de mois spécifié à la chaîne date_string spécifiée. La date est renvoyée au format par défaut (DELIM_M_D_Y) ou au format spécifié par l'argument input_format facultatif. Si vous souhaitez un format différent en sortie, utilisez DATE_FORMAT.
Si l'augmentation du mois par le nombre de mois spécifié génère une date non valide, le résultat est calculé de sorte à correspondre au dernier jour du mois, comme illustré dans le dernier exemple ci-dessous. Si nécessaire, les années bissextiles sont prises en compte. Par exemple, l'ajout d'un mois à 31-Jan-2012 renvoie 29-Feb-2012.
Exemples
ADD_MONTHS(12, '06-25-11') ajoute un an (12 mois) à la date spécifiée et renvoie la date 06-25-12.
ADD_MONTHS(3, '2011-06-25', DT_DELIM_Y_M_D) ajoute trois mois à la date spécifiée et renvoie la date 2011-09-25.
ADD_MONTHS(1, '02-28-2011') renvoie la date 03-28-2011.
ADD_MONTHS(1, '03-31-2012') renvoie la date 04-30-2012.
Fonctions associées
Convertit une date de input_format en output_format.