Как складывать даты в 1С: функции и практические приёмы

В языке 1С дата — это не число, а отдельный тип данных, поэтому прямое сложение вида Дата + 3 не работает так, как ожидает новичок: число прибавится в секундах, а не в днях. Для корректной арифметики с датами во встроенном языке предусмотрены специальные функции, и главная из них — ДобавитьКДате().

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

Ниже разобраны основные способы сложения дат в 1С: стандартные функции языка, операции с секундами, работа с производственными календарями и проверка корректности результата. Отдельно рассмотрены типичные ошибки, которые приводят к сдвигу дат или падению кода.

Что такое дата в 1С и почему нельзя просто прибавить число

Тип «Дата» в 1С хранит значение с точностью до секунды: год, месяц, день, часы, минуты, секунды. Внутри платформа оперирует этим значением как моментом времени, поэтому арифметическая операция Дата + Число интерпретирует число как количество секунд. Выражение ТекущаяДата() + 1 сдвинет дату на одну секунду, а не на один день.

Из этого следует простое правило: если нужно прибавить дни, часы или минуты, либо используйте специальные функции, либо явно переводите величину в секунды. Один день — это 86400 секунд, час — 3600, минута — 60. Такое сложение безопасно для дней и меньших единиц, потому что длительность дня и часа фиксирована.

А вот для месяцев и лет сложение через секунды недопустимо: месяцы имеют разную длину (28–31 день), и платформа сама должна решить, какую дату вернуть при переходе, например, от 31 января на месяц вперёд. Для таких операций существуют отдельные механизмы.

Функция ДобавитьКДате — основной способ сложения

Универсальная функция встроенного языка: ДобавитьКДате(ИсходнаяДата, ТипЧисла, Количество). Второй параметр задаёт единицу измерения строкой: "Секунда", "Минута", "Час", "День", "Неделя", "Месяц", "Квартал", "Год", "Декада", "Полугодие". Третий параметр — целое число, причём оно может быть отрицательным, что позволяет той же функцией вычитать даты.

Примеры использования:

ДатаОплаты = ДобавитьКДате(ДатаДокумента, "День", 14);   // +14 календарных дней
ДатаОтгрузки = ДобавитьКДате(ДатаЗаказа, "Час", 48);      // +48 часов
КонецГарантии = ДобавитьКДате(ДатаПродажи, "Год", 3);     // +3 года
ПрошлаяНеделя = ДобавитьКДате(ТекущаяДата(), "Неделя", -1); // минус неделя

Важная особенность: при добавлении месяцев, кварталов и лет функция корректно обрабатывает конец месяца. Если к 31 января прибавить один месяц, результатом будет последний день февраля, а не «несуществующее» 31 февраля. Это поведение отличает функцию от наивного сложения через секунды.

НоваяДата = ДобавитьКДате(ДатаНачала, "День", 10);
Если Месяц(НоваяДата) <> Месяц(ДатаНачала) Тогда
    Сообщить("Дата перешла в следующий месяц");
КонецЕсли;

Функция ДобавитьМесяц и нюансы конца месяца

Для смещения на месяцы в языке есть отдельная функция ДобавитьМесяц(Дата, КоличествоМесяцев). По сути она дублирует ДобавитьКДате(Дата, "Месяц", N), но исторически используется чаще и лучше читается в коде. Количество также может быть отрицательным.

Ключевой нюанс — поведение на границе месяца. Правило платформы: если исходный день не существует в целевом месяце, результатом становится последний день этого месяца. Так, ДобавитьМесяц('20260131', 1) вернёт 29.02.2026 (в високосном году), а не 02.03. Однако обратное смещение от 29 февраля на месяц назад даст 29 января, а не 31 — симметрии здесь нет, и это нужно учитывать в циклических расчётах.

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

Сложение через секунды: когда это допустимо

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

ДатаЧерез3Дня = ДатаНачала + 3 * 86400;        // +3 дня
ДатаЧерезПолтораЧаса = ДатаНачала + 90 * 60;   // +90 минут
НачалоСледующегоДня = НачалоДня(ДатаНачала) + 86400;

Граница применимости: секунды, минуты, часы, дни, недели (7 × 86400). Всё, что длиннее недели, — только через ДобавитьКДате(), потому что длительность месяца и года непостоянна. Нарушение этого правила — одна из самых коварных ошибок: код Дата + 30 * 86400 вместо «плюс один месяц» большую часть времени работает «почти правильно», но на длинных и коротких месяцах даёт смещение на 1–3 дня, которое обнаруживается только при сверке документов.

Для получения разности дат (обратная операция) используется функция РазностьДат(Дата1, Дата2, ТипЧисла), которая возвращает количество единиц между двумя датами, либо простое вычитание Дата2 - Дата1, дающее разницу в секундах.

Сложение рабочих дней по производственному календарю

Стандартные функции оперируют календарными днями, но в учётных задачах часто требуется прибавить именно рабочие дни: срок доставки «5 рабочих дней», дата платежа «не позднее 3 банковских дней». Здесь простая арифметика не подходит — нужен производственный календарь.

В типовых конфигурациях (БСП) для этого существует регистр сведений «Данные производственного календаря» и программный интерфейс общего модуля КалендарныеГрафики. Типовой подход — запросом выбрать даты, следующие за исходной, с признаком рабочего дня, и взять N-ю по счёту:

ВЫБРАТЬ ПЕРВЫЕ 5
Данные.Дата КАК Дата
ИЗ
РегистрСведений.ДанныеПроизводственногоКалендаря КАК Данные
ГДЕ
Данные.ПроизводственныйКалендарь = &Календарь
И Данные.Дата > &ДатаНачала
И Данные.ВидДня = ЗНАЧЕНИЕ(Перечисление.ВидыДнейПроизводственногоКалендаря.Рабочий)
УПОРЯДОЧИТЬ ПО
Данные.Дата

Из результата берётся последняя (пятая) дата — это и есть искомый срок. Если производственный календарь в базе не заполнен на нужный период, расчёт вернёт пустой или неверный результат, поэтому перед внедрением такой логики проверьте актуальность календаря на требуемый горизонт.

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

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

Отдельно проверьте поведение при пустой исходной дате. Пустая дата в 1С — это 01.01.0001, и ДобавитьКДате('00010101', "День", 14) честно вернёт 15.01.0001, не выдав ошибки. В прикладной логике такой результат почти всегда означает незаполненный реквизит, поэтому перед расчётом добавляйте проверку Если Не ЗначениеЗаполнено(ДатаДокумента) Тогда ....

Типичные ошибки при сложении дат

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

Выбор способа под конкретную задачу

Для массовых операций в запросах помните, что ДобавитьКДате() доступна и в языке запросов с тем же синтаксисом: ДОБАВИТЬКДАТЕ(Документ.Дата, ДЕНЬ, 14). Это позволяет выполнять расчёт на стороне СУБД без выборки данных в код, что существенно быстрее при обработке больших объёмов документов.

Частые вопросы