# addmonths — скрипт и функция диаграммы

Эта функция возвращает дату через n месяцев после даты startdate или, если n является отрицательным числом, — дату за n месяцев до даты startdate.

Синтаксис:

AddMonths(startdate, n , [ , mode])

**Тип возврата данных:** двойное значение

Аргументы:

аргументы AddMonths

| Аргумент | Описание |
| --- | --- |
| startdate | Начальная дата в виде метки времени, например '2012-10-12'. |
| n | Количество месяцев в виде положительного или отрицательного целого числа. |
| mode | Параметр mode указывает, добавляется ли месяц относительного начала или конца месяца. Если входная дата 28-го числа или выше, а параметр mode равен 1, то функция возвращает дату, которая отстоит на то же расстояние от конца месяца, что и входная дата. Значение mode по умолчанию — 0. |

Примеры и результаты:

Примеры и результаты

| Пример | Результат |
| --- | --- |
| `addmonths ('2003-01-29',3)` | Возвращает «2003-04-29» |
| `addmonths ('2003-01-29',3,0)` | Возвращает «2003-04-29» |
| `addmonths ('2003-01-29',3,1)` | Возвращает «2003-04-28» |
| `addmonths ('2003-01-29',1,0)` | Возвращает «2003-02-28» |
| `addmonths ('2003-01-29',1,1)` | Возвращает «2003-02-26» |
| `addmonths ('2003-02-28',1,0)` | Возвращает «2003-03-28» |
| `addmonths ('2003-02-28',1,1)` | Возвращает «2003-03-31» |