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

Другое · 7 мин

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

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

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

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

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

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

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

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

Как прибавить дни к дате через оператор плюс

Самый простой способ — записать выражение вида НоваяДата = ИсходнаяДата + КоличествоДней. Это работает как в модулях объектов, так и в языке запросов. Количество дней может быть положительным, отрицательным или нулём. Результат присваивается реквизиту документа, регистра или переменной, после чего доступен для сохранения и вывода.

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

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

Прибавление месяцев и лет к дате

Оператор сложения с числом прибавляет только дни, поэтому для месяцев и лет его напрямую использовать нельзя. Чтобы прибавить месяц, нужно изменить компонент месяца даты, а при переходе через декабрь — увеличить год. Аналогично с годами: меняется компонент года, а месяц и день сохраняются. При этом возможны граничные ситуации, например 31 января плюс один месяц не существует, поэтому результат требует уточнения.

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

Сравнение вариантов

Оператор плюс с числом

Подходит для прибавления календарных дней, не учитывает праздники и выходные

Расчёт через компоненты даты

Подходит для месяцев и лет, требует проверки границ месяцев и високосных лет

Производственный календарь

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

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

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

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

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

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

Смещение даты
Норма

Дата изменилась на указанное число дней

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

Дата не изменилась или сдвинулась неверно

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

Время сохранено или обнулено намеренно

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

Время изменилось непредсказуемо

Границы диапазона
Норма

Дата находится в допустимом интервале

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

Дата выходит за пределы поддерживаемого диапазона

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

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

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

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

Альтернативы и когда обращаться к разработчику

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли прибавить к дате число в языке запросов 1С?

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

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

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

Учитывает ли оператор плюс праздники и выходные?

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

Как прибавить к дате один месяц?

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

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

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