Прибавление числа к дате в 1С: все методы от простых к сложным

Работа с датами в 1С:Предприятие 8.3 — одна из самых востребованных задач как для программистов, так и для обычных пользователей. Чаще всего требуется прибавить к текущей дате определенное количество дней, месяцев или лет — будь то расчет сроков оплаты, планирование задач или автоматическое формирование отчетов. Однако даже опытные специалисты иногда путаются в синтаксисе или выбирают неоптимальные методы.

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

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

1. Базовый метод: функция ДобавитьДень

Самый простой и интуитивно понятный способ — использование встроенной функции ДобавитьДень. Она позволяет прибавить к дате заданное количество дней, автоматически корректируя месяц и год при переполнении.

Синтаксис функции крайне лаконичен:

ДобавитьДень(Дата, КоличествоДней)

Где:

• 📅 Дата — исходная дата (тип Дата)
• ➕ КоличествоДней — целое число (может быть отрицательным для вычитания)

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

// Прибавить 5 дней к текущей дате
Результат = ДобавитьДень(ТекущаяДата, 5);

// Вычесть 3 дня из конкретной даты
Результат = ДобавитьДень('2026-12-31', -3); // Вернет'2026-12-28'

Важная особенность: функция работает только с полными днями. Если вам нужно прибавить часы или минуты, потребуются другие подходы, которые мы рассмотрим далее.

⚠️ Внимание: При передаче некорректной даты (например,'2026-02-30') функция не выдаст ошибку, а автоматически скорректирует значение на ближайшую валидную дату ('2026-03-01'). Это может приводить к скрытым ошибкам в логике программ.

2. Работа с месяцами и годами: ДобавитьМесяц и ДобавитьГод

Когда требуется прибавить не дни, а месяцы или годы, удобнее использовать специализированные функции ДобавитьМесяц и ДобавитьГод. Их поведение аналогично ДобавитьДень, но с учетом специфики календарных периодов.

Сравнение работы функций:

Практический пример для бизнес-задач:

// Рассчитать дату окончания гарантии (1 год и 2 месяца)
ДатаОкончанияГарантии = ДобавитьМесяц(
ДобавитьГод(ДатаПродажи, 1),
2
);

Обратите внимание на поведение при некорректных датах:

// Что вернет этот код?
Результат = ДобавитьМесяц('2026-01-31', 1); //'2026-02-29' (а не'2026-03-03')

⚠️ Внимание: При работе с финансовыми периодами (кварталы, полугодия) лучше использовать комбинацию ДобавитьМесяц с проверкой границ периодов через НачалоКвартала или КонецГода.

3. Арифметические операции с датами

Платформа 1С позволяет выполнять арифметические операции непосредственно с типом Дата. Это удобно для быстрых расчетов, но требует понимания внутреннего представления дат.

Основные правила:

• ➖ Вычитание двух дат возвращает количество дней между ними
• ➕ Прибавление числа к дате эквивалентно ДобавитьДень
• ➖ Вычитание числа из даты также работает как ДобавитьДень с отрицательным значением

Примеры:

// Способ 1: прибавление через сложение
ДатаОплаты = ТекущаяДата + 14; // Через 2 недели

// Способ 2: вычисление разницы
ДнейДоДедлайна ='2026-12-31' - ТекущаяДата;

// Способ 3: вычитание дней
ПрошлыйМесяц = ТекущаяДата - 30;

Используйте только целые числа|Учитывайте переходы на новый год|Проверяйте результат на корректность|Избегайте операций с временем (если не нужно)-->

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

Интересный кейс: как прибавить ровно 1 рабочий день, исключая выходные?

4. Работа с временными метками (ДатаВремя)

Когда требуется прибавить не только дни, но и часы/минуты, необходимо использовать тип ДатаВремя. Для этого предназначены функции ДобавитьСекунду, ДобавитьМинуту и ДобавитьЧас.

Ключевые особенности:

• ⏰ Тип ДатаВремя хранит дату и время одновременно
• 🌍 Учитывает временные зоны (если настроены в конфигурации)
• ⚡ Более ресурсоемкий, чем простая Дата

Пример сложного расчета:

// Добавить 2 дня, 3 часа и 30 минут к текущему моменту
НоваяДата = ДобавитьМинуту(
ДобавитьЧас(
ДобавитьДень(ТекущаяДатаВремя, 2),
3
),
30
);

Для преобразования между типами используйте:

// Из Дата в ДатаВремя (время будет 00:00:00)
ДатаВремяНачалоДня = НачалоДня(ТекущаяДата);

// Из ДатаВремя в Дата (время отбрасывается)
ТолькоДата = Дата(ТекущаяДатаВремя);

⚠️ Внимание: При сетевой работе с базой 1С временные метки могут автоматически корректироваться согласно настройкам сервера. Всегда проверяйте результат на клиентской машине, если точность критична.

5. Продвинутые техники: календари и производственные календари

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

Алгоритм работы:

1. Создать объект Календарь (встроенный или свой)
2. Загрузить в него данные о рабочих/выходных днях
3. Использовать метод ДобавитьРабочиеДни

Пример с встроенным производственным календарем:

// Получаем календарь"Основной" (настроен в конфигурации)
Календарь = Календари.Основной;

// Добавляем 5 рабочих дней к текущей дате
ДатаОтгрузки = Календарь.ДобавитьРабочиеДни(ТекущаяДата, 5);

Для сложных сценариев можно создавать собственные календари:

НовыйКалендарь = Новый Календарь;
НовыйКалендарь.ДобавитьПраздник('2026-05-09'); // День Победы
НовыйКалендарь.ДобавитьРабочийДень('2026-05-04'); // Перенос выходного

Результат = НовыйКалендарь.ДобавитьРабочиеДни('2026-05-01', 3);

- Сроков оплаты по договорам

- Даты отгрузки товаров

- Графиков выплат зарплаты

- Плановых ремонтных работ-->

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

6. Обработка ошибок и случаи

При работе с датами в 1С часто возникают неочевидные ошибки. Рассмотрим типичные проблемы и способы их решения.

Частые ошибки:

• 🗓️ Некорректные даты:'2026-02-30' автоматически конвертируется в'2026-03-01'
• ⏳ Переполнение: прибавление большого числа дней может выйти за пределы поддерживаемого диапазона (01.01.0001 — 31.12.9999)
• 🌐 Временные зоны: разница между сервером и клиентом
• 🔄 Кэширование: даты в запросах могут кэшироваться некорректно

Как защититься от ошибок:

// Проверка корректности даты
Если Не ЗначениеЗаполнено(ДатаДокумента) Или ДатаДокумента ='00010101' Тогда
ВызватьИсключение"Некорректная дата документа!";
КонецЕсли;

// Безопасное прибавление с проверкой диапазона
Попытка
НоваяДата = ДобавитьГод(Дата, 100);
Исключение
Сообщить("Превышен поддерживаемый диапазон дат!");
КонецПопытки;

Особый случай: работа с пустыми датами. В 1С пустая дата представляется как'00010101' (1 января 1 года). Любые операции с такой датой приведут к ошибке.

// Правильная проверка на пустую дату
Если ДатаДокумента ='00010101' Тогда
ДатаДокумента = ТекущаяДата;
КонецЕсли;

⚠️ Внимание: При обмене данными между системами даты в формате 1С могут интерпретироваться по-разному. Всегда согласовывайте форматы дат при интеграции с внешними сервисами (например,'ДД.ММ.ГГГГ' vs'ГГГГ-ММ-ДД').

7. Оптимизация производительности при массовых операциях

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

Рекомендации по оптимизации:

• ⚡ Избегайте циклов — используйте массовые операции с датами
• 📊 Кэшируйте результаты часто используемых расчетов
• 🔄 Минимизируйте преобразования типов
• 📅 Используйте серверные процедуры для сложных вычислений

Сравнение производительности (тест на 100,000 операций):

Пример оптимизированного кода для массовой обработки:

// Неоптимально (медленно):
Для Каждого Строки Из ТаблицаДокументов Цикл
Строки.ДатаОплаты = ДобавитьДень(Строки.Дата, 5);
КонецЦикла;

// Оптимально (в 3-5 раз быстрее):
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Дата КАК ИсходнаяДата,
| ДОБАВИТЬДЕНЬ(Дата, 5) КАК ДатаОплаты
|ИЗ
| ТаблицаДокументов";
Результат = Запрос.Выполнить;

8. Интеграция с внешними системами

При обмене данными с другими системами (например, Excel, SQL, API) формат дат может отличаться. Важно правильно конвертировать значения, чтобы избежать ошибок.

Типичные форматы и их обработка:

Пример обработки даты из JSON:

// JSON содержит дату в формате"/Date(1672531200000)/"
Функция РаспарситьДатаИзJSON(СтрокаJSON)
ЧислоМиллисекунд = Сред(СтрокаJSON, 7, СтрДлина(СтрокаJSON)-8);
Возврат ДобавитьСекунду('1970-01-01', Число(ЧислоМиллисекунд)/1000);
КонецФункции

Для обратного преобразования (из 1С во внешний формат):

// Экспорт даты в формат ISO 8601 для API
Функция ДатаВISOФормат(Дата1С)
Возврат Формат(Дата1С,"ДФ=yyyy-MM-ddTHH:mm:ss");

// Или для миллисекунд с 1970 года
Секунды = (Дата1С -'1970-01-01') * 86400;
Возврат"/Date(" + (Секунды * 1000) +")/";
КонецФункции

⚠️ Внимание: При интеграции с Excel учитывайте, что в Windows и macOS используются разные стартовые даты для числового представления (1899 vs 1904 год). Всегда уточняйте настройку"Системы дат 1904" в параметрах Excel.

FAQ: Частые вопросы по работе с датами в 1С

Календарь = Календари.Основной;
Результат = Календарь.ДобавитьРабочиеДни(ТекущаяДата, 5);

// Прибавить 1.5 дня (36 часов)
Результат = ДобавитьЧас(ТекущаяДатаВремя, 36);

РазницаВДнях = Дата2 - Дата1;