ADD_MONTHS

Синтаксис

ADD_MONTHS(date, months)

Описание

ADD_MONTHS добавляет целое число месяцев к заданной дате (DATE, DATETIME или TIMESTAMP), возвращая результирующую дату.

months может быть положительным или отрицательным.

Компонент дня результата останется таким же, как указано в date, если только результирующий месяц не имеет меньше дней, чем компонент дня заданной даты. В этом случае днём будет последний день результирующего месяца.

Возвращает NULL, если задана некорректная дата или в качестве аргумента передан NULL.

Примеры

SELECT ADD_MONTHS('2012-01-31', 2);
+-----------------------------+
| ADD_MONTHS('2012-01-31', 2) |
+-----------------------------+
| 2012-03-31                  |
+-----------------------------+

SELECT ADD_MONTHS('2012-01-31', -5);
+------------------------------+
| ADD_MONTHS('2012-01-31', -5) |
+------------------------------+
| 2011-08-31                   |
+------------------------------+

SELECT ADD_MONTHS('2011-01-31', 1);
+-----------------------------+
| ADD_MONTHS('2011-01-31', 1) |
+-----------------------------+
| 2011-02-28                  |
+-----------------------------+

SELECT ADD_MONTHS('2012-01-31', 1);
+-----------------------------+
| ADD_MONTHS('2012-01-31', 1) |
+-----------------------------+
| 2012-02-29                  |
+-----------------------------+

SELECT ADD_MONTHS('2012-01-31', 2);
+-----------------------------+
| ADD_MONTHS('2012-01-31', 2) |
+-----------------------------+
| 2012-03-31                  |
+-----------------------------+

SELECT ADD_MONTHS('2012-01-31', 3);
+-----------------------------+
| ADD_MONTHS('2012-01-31', 3) |
+-----------------------------+
| 2012-04-30                  |
+-----------------------------+

См. также

• SQL_MODE=ORACLE