К статье
Практический материал

Другое · 5 мин

Как к дате прибавить дни в 1С: инструкция и примеры

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

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

Сделать это можно в модуле объекта, в общем модуле, в языке запросов или в отчете, но способы и синтаксис отличаются.

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

Способы прибавления дней в встроенном языке

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

Если нужно прибавить не дни, а более мелкий интервал, можно работать через секунды, но для бизнес-задач это менее удобно и менее читаемо.

Когда подходит модульный расчет

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

Порядок действий в модуле
  1. 1
    Определите исходную дату и количество дней
  2. 2
    Вызовите функцию прибавления дней
  3. 3
    Запишите результат в реквизит или переменную
  4. 4
    Сравните полученную дату с ожидаемой

Перед записью результата убедитесь, что исходная дата пустая или заполнена корректно. Пустая дата может привести к неожиданному значению после прибавления.

Если расчет выполняется в цикле по табличной части, проверяйте каждую строку отдельно, чтобы ошибка в одной дате не сломала весь документ.

Прибавление дней в языке запросов

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

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

Особенности параметров запроса

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

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

Учет рабочих дней и праздников

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

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

Признак того, что нужен календарь

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

Проверка результата и границы допустимых значений

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

Обращайте внимание на границы допустимого диапазона дат в платформе. Очень большие или отрицательные смещения могут привести к некорректному значению.

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

Контрольные точки

Как проверить результат

Итоговая дата больше исходной
Норма

Нормальное состояние

Тревожный признак

Дата не изменилась или стала раньше

Время суток
Норма

Соответствует ожиданию

Тревожный признак

Появилось неожиданное время или сдвиг

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

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

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

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

Типичные ошибки
01
Прибавление рабочих дней как календарных приводит к неверному сроку
02
Передача строки вместо числа вызывает ошибку выполнения
03
Изменение даты проведенного документа без анализа последствий

Когда править код самостоятельно, а когда обращаться к разработчику

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

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

Итог

Что важно запомнить

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

Можно ли прибавить дни к дате в отчете без программирования?

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

Учитываются ли праздники при обычном прибавлении дней?

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

Что делать, если после прибавления дней дата стала раньше?

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

Безопасно ли менять дату у проведенного документа?

Не всегда. Изменение даты может повлиять на регистры, остатки и налоговые расчеты, поэтому такие правки лучше согласовывать с ответственным за учет.

Нужно ли тестировать изменение после обновления платформы?

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