Как в 1С прибавить день к дате: методы и примеры кода

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

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

Прямая арифметика с датами в встроенном языке

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

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

Рассмотрим пример кода, где мы берем текущую дату и смещаем её на один день вперед:

ТекущаяДата = ТекущаяДата();
НоваяДата = ТекущаяДата + 1;
Сообщить("Новая дата: " + НоваяДата);

Такой подход идеально подходит для простых сценариев, где требуется смещение на фиксированное количество дней. Использование оператора + гарантирует корректную обработку переходов через конец месяца. Например, если к 31 января прибавить единицу, система автоматически вернет 1 февраля, учитывая количество дней в конкретном месяце.

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

💡

Для получения даты "вчера" достаточно использовать выражение ТекущаяДата() - 1. Это работает аналогично прибавлению, но со знаком минус.

Использование встроенной функции ДобавлениеДаты

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

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

Пример использования функции для прибавления одного дня выглядит следующим образом:

ИсходнаяДата = '20231231';
// Добавляем 1 день
Результат = ДобавлениеДаты(ИсходнаяДата, 1, Период.День);
Сообщить(Результат); // Выведет 01.01.2026

Функция также корректно обрабатывает сложные календарные переходы. Если вы решите прибавить месяц к дате 31 января, результат будет зависеть от конкретного года: для невисокосного года это будет 28 февраля, а для високосного — 29 февраля. Логика платформы автоматически подстраивается под календарь.

☑️ Проверка корректности работы с датами

Учет високосных годовПереход через конец месяцаУчет летнего/зимнего времениКорректное отображение в форме

Выполнено: 0 / 4

Операции с датами в языке запросов 1С

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

В тексте запроса вы можете использовать оператор ДАТАДОБАВИТЬ или прямое сложение в условии ГДЕ. Прямое сложение часто выглядит компактнее и выполняется быстрее, так как не требует вызова дополнительной функции для каждой строки результата. Однако для сложных расчетов внутри виртуальных таблиц лучше использовать специализированные функции.

Пример запроса, выбирающего документы, дата которых больше текущей на один день:

ВЫБРАТЬ Документы.Ссылка, Документы.Дата ИЗ Документ.РеализацияТоваровУслуг КАК Документы ГДЕ

Документы.Дата > &ТекущаяДата + 1

Здесь параметр &ТекущаяДата передается из кода 1С. Поэтому при сравнении дат часто возникает необходимость отсекать время, используя функцию НАЧАЛОДНЯ, чтобы выборка работала корректно.

Функция в запросе	Описание действия	Пример использования
`ДАТАДОБАВИТЬ`	Добавляет интервал к дате	`ДАТАДОБАВИТЬ(Дата, 1, ДЕНЬ)`
`НАЧАЛОДНЯ`	Обнуляет время до 00:00:00	`НАЧАЛОДНЯ(ТекущаяДата())`
`КОНЕЦДНЯ`	Устанавливает время 23:59:59	`КОНЕЦДНЯ(ТекущаяДата())`
`РАЗНОСТЬДАТ`	Вычисляет разницу между датами	`РАЗНОСТЬДАТ(Дата1, Дата2, ДЕНЬ)`

⚠️ Внимание: В запросах нельзя использовать переменные языка 1С напрямую внутри текста запроса. Все внешние значения должны передаваться через параметры, начинающиеся со знака амперсанда (&).

Нюансы работы с типом ДатаВремя

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

Частой ошибкой новичков является игнорирование временной составляющей при сравнении дат. Если вы сравниваете дату документа (которая может быть 10:00) с датой отсечки (которая установлена как начало дня 00:00), условие может сработать не так, как ожидалось. Всегда явно приводите даты к началу дня, если время не имеет значения для вашей бизнес-логики.

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

ДатаСВременем = ТекущаяДата(); // Например, 25.10.2023 14:20:00
ДатаБезВремени = НачалоДня(ДатаСВременем); // 25.10.2023 00:00:00
Завтра = ДатаБезВремени + 1; // 26.10.2023 00:00:00

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

Почему время важно в 1С?

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

Обработка переходов через границы периодов

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

Например, если вы прибавляете один месяц к дате 31 января, система не выдаст ошибку о несуществующем 31 февраля. Вместо этого она вернет последний допустимый день февраля (28 или 29). Это поведение зафиксировано в стандартах платформы и является надежным инструментом для планирования.

Тем не менее, при работе с интервалами, кратными месяцу или году, стоит помнить о специфике бизнес-процессов. Если договор заключен 31 числа, то ежемесячная оплата, рассчитанная простым добавлением месяца, может "съезжать" на 28-30 число в последующих месяцах. В таких случаях лучше использовать специальные алгоритмы расчета дат платежей, учитывающие рабочие дни.

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

📅 31 января + 1 месяц = 28 (или 29) февраля
📅 30 марта + 1 день = 31 марта
📅 31 декабря + 1 день = 1 января следующего года
📅 28 февраля (невисокосный) + 1 год = 28 февраля

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

💡

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

Частые ошибки и методы отладки

При работе с датами разработчики часто сталкиваются с проблемами локализации и форматов отображения. То, что в коде выглядит как корректная дата, в форме может отображаться неправильно из-за настроек регионального стандарта пользователя. Всегда проверяйте не только значение даты, но и её тип и формат строкового представления.

Еще одна распространенная проблема — работа с NULL-значениями. Попытка прибавить день к пустой дате (Неопределено) приведет к ошибке выполнения. Перед выполнением арифметических операций обязательно проверяйте переменную на заполненность с помощью оператора ЗначениеЗаполнено.

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

Если ЗначениеЗаполнено(ПлановаяДата) Тогда
ФактическаяДата = ПлановаяДата + 1;
Иначе
ФактическаяДата = ТекущаяДата();
КонецЕсли;

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

💡

Используйте метод Формат() для отладки, чтобы выводить дату в понятном виде: Сообщить(Формат(Дата, "ДФ=dd.MM.yyyy")).

Можно ли прибавить к дате дробное число, например 1.5?

Да, можно. Дробная часть будет интерпретирована как доля суток. 0.5 суток равны 12 часам. Это полезно для расчета точного времени завершения работ, но требует осторожности при сравнении дат.

В чем разница между сложением даты и функцией ДобавлениеДаты?

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

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

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

Что будет, если прибавить день к 31 декабря?

Система корректно переключит год. Результатом будет 1 января следующего года. Номер года увеличится на единицу автоматически.

Влияет ли часовой пояс на операцию прибавления дня?

Внутри одной базы 1С все даты хранятся в локальном времени компьютера пользователя или сервера (в зависимости от режима). Операция сложения работает с локальным значением, поэтому смена пояса может сдвинуть "сутки" относительно UTC, но логика +1 останется прежней.