Как в 1С добавить месяц к дате

При разработке и доработке конфигураций 1С регулярно возникает задача сдвинуть дату на один или несколько месяцев: рассчитать дату окончания договора, сформировать период отчёта, определить срок оплаты счёта. Встроенный язык платформы предоставляет для этого специальную функцию ДобавитьМесяц, которая корректно обрабатывает разную длину месяцев и переход через границу года.

Ошибка новичков — прибавлять к дате фиксированное число секунд (например, 30 24 60 * 60) или дней. Такой подход ломается на феврале, на месяцах с 31 днём и при переходе через год. Функция ДобавитьМесяц решает эти проблемы на уровне платформы, но и у неё есть особенности, которые нужно понимать, чтобы не получить неожиданный результат.

Материал ориентирован на разработчиков и администраторов, работающих с кодом на встроенном языке 1С (тонкий клиент, толстый клиент, сервер, веб-клиент — синтаксис везде одинаковый). Разобраны синтаксис, поведение на граничных датах, вычитание месяцев, работа в запросах и типичные ошибки.

Синтаксис функции ДобавитьМесяц

Функция имеет два параметра: исходная дата и количество месяцев, на которое её нужно сдвинуть. Второй параметр — целое число, оно может быть положительным (сдвиг вперёд) или отрицательным (сдвиг назад).

НоваяДата = ДобавитьМесяц(ИсходнаяДата, ЧислоМесяцев);

Функция возвращает значение типа Дата. Время, если оно было задано в исходной дате, сохраняется без изменений. Если передать пустую дату (01.01.0001), результат также будет некорректным для бизнес-логики — это стоит проверять заранее.

ДатаНачала = Дата(2026, 1, 15);
ДатаОкончания = ДобавитьМесяц(ДатаНачала, 1); // 15.02.2026
ДатаГодНазад = ДобавитьМесяц(ДатаНачала, -12); // 15.01.2023

Важно: функция не изменяет переданную переменную, а возвращает новое значение. Типичная ошибка — вызвать ДобавитьМесяц(Дата, 1) без присваивания результата и ожидать, что переменная Дата изменилась.

Как прибавить один месяц к дате

Самый частый сценарий — сдвинуть дату ровно на один месяц вперёд. Для этого достаточно одной строки кода.

ДатаДокумента = ТекущаяДатаСеанса();
ДатаСледующегоПлатежа = ДобавитьМесяц(ДатаДокумента, 1);

Если нужно прибавить месяц к дате, введённой пользователем в форму, предварительно убедитесь, что поле заполнено. Пустая дата в реквизите формы имеет значение 01.01.0001, и сдвиг даст 01.02.0001 — такой результат, скорее всего, попадёт в отчёты и документы как мусор.

1. 1
   Получите или проверьте исходную дату: она должна быть заполнена и иметь тип Дата
2. 2
   Вызовите ДобавитьМесяц(ИсходнаяДата, 1) и присвойте результат переменной
3. 3
   При необходимости приведите результат к началу или концу дня через НачалоДня() или КонецДня()
4. 4
   Проверьте результат на граничных датах: 31 января, 29 февраля, 31 декабря

Как вычесть месяц из даты

Для сдвига назад отдельной функции не требуется — передайте отрицательное число месяцев. Это удобно при расчёте периодов «за прошлый месяц», дат начала отчётных интервалов и проверки просрочек.

МесяцНазад = ДобавитьМесяц(ТекущаяДатаСеанса(), -1);
КварталНазад = ДобавитьМесяц(ТекущаяДатаСеанса(), -3);

Тот же приём работает в циклах: например, чтобы получить список дат за последние 12 месяцев, достаточно в цикле вызывать ДобавитьМесяц с параметром от -1 до -12.

Особенности на границах месяца и года

Главная тонкость функции — поведение, когда в целевом месяце нет соответствующего числа. Если исходная дата — 31 января, то после прибавления одного месяца результатом будет последний день февраля (28 или 29 число в зависимости от високосности). Платформа не «переносит» лишние дни на март, а ограничивает результат концом месяца.

Это создаёт эффект необратимости: ДобавитьМесяц(ДобавитьМесяц('31.01.2026', 1), -1) вернёт не 31 января, а 29 января (или 30-е в зависимости от промежуточного результата). Если бизнес-логика требует «тот же день месяца», нужна дополнительная проверка и корректировка.

Переход через год обрабатывается корректно: прибавление месяца к декабрьской дате даёт январь следующего года, вычитание из января — декабрь предыдущего. Здесь подводных камней нет.

Добавление месяца в запросе

В языке запросов 1С функции ДобавитьМесяц нет — там используется функция ДОБАВИТЬКДАТЕ с указанием единицы измерения МЕСЯЦ.

ВЫБРАТЬ
ДОБАВИТЬКДАТЕ(&ДатаНачала, МЕСЯЦ, 1) КАК ДатаОкончания

Поведение на граничных датах аналогично встроенной функции. Если дата для запроса известна заранее, часто проще вычислить её в коде через ДобавитьМесяц и передать в запрос параметром — так логика остаётся в одном месте и проще тестируется.

Типичные ошибки и ограничения

Первая распространённая ошибка — прибавление к дате 30 дней через арифметику секунд. Такой код «почти работает» и долго не вызывает подозрений, пока не встречается февраль или месяц с 31 днём.

Вторая ошибка — потеря результата функции из-за отсутствия присваивания. Третья — работа с незаполненной датой: сдвиг пустой даты не вызывает исключения, но даёт бессмысленное значение, которое потом попадает в документы. Четвёртая — ожидание симметрии: «плюс месяц, минус месяц» не всегда возвращает исходную дату из-за обрезания на конце короткого месяца.

Ещё одно ограничение: функция работает с типом Дата, а не со строками. Если дата приходит из внешнего источника в виде текста, её сначала нужно преобразовать, например через Дата() с параметрами или функции разбора строки.

Практические примеры

Расчёт даты окончания договора, заключённого на N месяцев:

Функция ДатаОкончанияДоговора(ДатаЗаключения, СрокМесяцев)
Если Не ЗначениеЗаполнено(ДатаЗаключения) Тогда
Возврат Неопределено;
КонецЕсли;
Возврат ДобавитьМесяц(ДатаЗаключения, СрокМесяцев) - 1;
КонецФункции

Вычитание одной секунды в конце переводит дату на конец предыдущего дня — стандартный приём для «договор действует по день накануне годовщины». Формирование периода «прошлый месяц» для отчёта:

ДатаНачала = НачалоМесяца(ДобавитьМесяц(ТекущаяДатаСеанса(), -1));
ДатаОкончания = КонецМесяца(ДатаНачала);

Часто задаваемые вопросы