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

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

Главная тонкость — арифметика календаря. Вычитание месяца из 31 марта должно дать 28 (или 29) февраля, а не несуществующее «31 февраля». Функция ДобавитьМесяц решает это автоматически: если исходный день не существует в целевом месяце, результатом становится последний день этого месяца. Именно поэтому ручные вычисления через количество дней (30 или 31) почти всегда дают ошибку.

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

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

Функция доступна во встроенном языке 1С:Предприятие 8 во всех клиентских и серверных контекстах. Её объявление выглядит так:

Результат = ДобавитьМесяц(ИсходнаяДата, КоличествоМесяцев);
// ИсходнаяДата — значение типа Дата
// КоличествоМесяцев — целое число, может быть отрицательным

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

Функция возвращает новое значение типа Дата, исходная переменная не изменяется — результат нужно присвоить. Время дня (часы, минуты, секунды) при сдвиге сохраняется: если исходная дата была 15.03.2026 14:30:00, то после вычитания месяца получится 15.02.2026 14:30:00.

Базовые примеры вычитания месяцев

Простейший сценарий — вычесть фиксированное число месяцев из текущей даты или из реквизита документа:

ДатаОтчета = ДобавитьМесяц(ТекущаяДатаСеанса(), -6); // полгода назад
ДатаНачалаКвартала = ДобавитьМесяц(НачалоКвартала(ТекущаяДатаСеанса()), -3); // начало прошлого квартала
ДатаОтгрузки = ДобавитьМесяц(Документ.Дата, -1); // месяц до даты документа

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

Для вычитания произвольного количества, заданного пользователем (например, параметр периода в отчёте), достаточно взять значение со знаком минус:

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

Особенность: конец месяца и несуществующие дни

Ключевое правило функции: если день исходной даты отсутствует в целевом месяце, результатом будет последний день этого месяца. Вычитание одного месяца из 31 марта даст 28 или 29 февраля (в зависимости от високосности), а из 31 мая — 30 апреля.

Это поведение удобно для расчётов «месяц назад», но может давать неожиданный эффект при цепочках операций. Если из 31 марта вычесть месяц (получим 28 февраля), а затем прибавить месяц обратно, результатом будет 28 марта, а не исходное 31 марта. Операция необратима — учитывайте это при итеративных расчётах графиков платежей.

Если бизнес-логика требует всегда получать конец месяца, надёжнее явно обернуть результат в КонецМесяца:

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

Вычитание месяцев в запросах

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

ВЫБРАТЬ
	ДОБАВИТЬКДАТЕ(&ТекущаяДата, МЕСЯЦ, -3) КАК ДатаТриМесяцаНазад,
	Продажи.Период КАК Период
ИЗ
	РегистрНакопления.Продажи КАК Продажи
ГДЕ
	Продажи.Период >= ДОБАВИТЬКДАТЕ(&ТекущаяДата, МЕСЯЦ, -12)

Типичное применение — отбор данных за последние N месяцев без вычисления дат на стороне кода. Это удобно, когда граница периода должна зависеть от параметра запроса, а не от заранее рассчитанной переменной.

Обратите внимание: в запросе нельзя передать отрицательное число через параметр напрямую в третий аргумент в некоторых конструкциях построителя — надёжнее передавать уже вычисленное отрицательное значение или использовать выражение -&КоличествоМесяцев, если оно поддерживается в вашем контексте. Проще всего вычислить дату в коде через ДобавитьМесяц и передать в запрос готовым параметром.

Расчёт периодов: начало и конец диапазона

На практике вычитание месяцев почти всегда связано с построением периода отчёта: «последние 6 месяцев», «прошлый квартал», «аналогичный месяц прошлого года». Здесь функция комбинируется с НачалоМесяца, КонецМесяца, НачалоДня.

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

Пример для аналогичного периода прошлого года — вычитаем 12 месяцев от обеих границ текущего периода:

НачалоПрошлогоГодаПериод = ДобавитьМесяц(НачалоТекущегоПериода, -12);
КонецПрошлогоГодаПериод  = ДобавитьМесяц(КонецТекущегоПериода, -12);

Такой подход сохраняет длину периода и сдвигает его ровно на год назад, что корректно для сравнительных отчётов «год к году».

Типичные ошибки и как их избежать

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

Если ЗначениеЗаполнено(ИсходнаяДата) Тогда
	НоваяДата = ДобавитьМесяц(ИсходнаяДата, -КоличествоМесяцев);
Иначе
	НоваяДата = Неопределено;
КонецЕсли;

Проверка корректности результата

После внедрения расчёта проверьте его на граничных случаях. Минимальный набор контрольных точек: 31 марта (переход на февраль), 1 января (переход через год), 29 февраля високосного года, 31 мая (месяц из 30 дней).

Для отладки удобно вывести промежуточные значения через Сообщить() или окно «Вычислить выражение» в конфигураторе. Если расчёт выполняется в запросе, временно выведите вычисленную дату отдельным полем выборки и сверьте с ожидаемым значением.

FAQ