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

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

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

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

Основы работы с типом данных Дата

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

Если вы напишете код Дата + 1, то к исходной дате прибавится ровно одни сутки. Это поведение является стандартным для большинства операций в коде, но требует осторожности при работе с месяцами.

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

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

Прямое сложение дней в коде и запросах

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

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

ДатаОтгрузки = ТекущаяДата();
СрокОплаты = ДатаОтгрузки + 10;

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

• 📅 Для добавления дней используйте оператор + с целым числом.
• 📅 Для вычитания дней используйте оператор - с целым числом.
• 📅 Результатом операции всегда является новый объект типа Дата.

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

Использование функции ДобавлениеМесяца

Когда речь заходит о прибавлении месяцев, ситуация усложняется. Простое умножение количества месяцев на среднее число дней (например, 30) не даст точного результата из-за разной длительности месяцев. Для решения этой задачи в платформе предусмотрена специальная функция ДобавлениеМесяца.

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

Синтаксис вызова выглядит следующим образом:

НоваяДата = ДобавлениеМесяца(ИсходнаяДата, КоличествоМесяцев);

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

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

Рассмотрим практический пример. Если у нас есть дата 31 января и мы прибавляем один месяц, результатом будет 28 (или 29) февраля. Если же мы прибавим месяц к 30 января, результатом станет 28 (или 29) февраля, так как 30 числа в феврале не существует. Система всегда выбирает максимально возможную дату в целевом месяце.

Прибавление лет и работа с високосными годами

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

Тем не менее, особый интерес представляет поведение системы при работе с датой 29 февраля. Это уникальный случай, который часто вызывает вопросы у разработчиков. Если вы пытаетесь прибавить год (или кратное 12 месяцев) к дате 29.02.2026 (високосный год), то в 2026 году (невисокосном) такой даты не существует.

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

Исходная дата	Интервал	Результат	Комментарий
29.02.2026	+1 год	28.02.2026	Коррекция на последний день
31.01.2026	+1 месяц	29.02.2026	Високосный год
31.01.2023	+1 месяц	28.02.2023	Обычный год
30.03.2026	-1 месяц	29.02.2026	Коррекция дня

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

Как проверить високосный год в 1С?

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

Функции начала и конца периодов

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

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

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

• 🚀 Используйте НачалоПериода(Дата) + Интервал для перехода к началу следующего шага.
• 🚀 Используйте КонецПериода(Дата) для получения дедлайнов.
• 🚀 Комбинируйте функции для сложных сдвигов, например, "третий понедельник следующего месяца".

Пример получения первого дня следующего квартала:

ДатаСегодня = ТекущаяДата();
НачалоСледКвартала = НачалоКвартала(ДатаСегодня + 92);

Здесь мы прибавляем 92 дня (максимальная длина квартала), чтобы гарантированно попасть в следующий квартал, а затем функцией НачалоКвартала обрезаем дату до первого числа. Это надежный паттерн, не зависящий от текущего дня месяца.

⚠️ Внимание: Функции начала и конца периода обрезают время до 00:00:00 или 23:59:59 соответственно. Если вам важна точность до секунд внутри периода, сохраняйте исходную дату в отдельной переменной перед применением этих функций.

Особенности вычисления дат в запросах

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

Для работы с месяцами в запросах часто используют трюк с функцией ДАТАВРЕМЯ или вычисляют смещение через дни, если точность до дня не критична. Но более правильным подходом является подготовка параметров в коде перед выполнением запроса. Вы вычисляете нужную дату в 1С, а в запрос передаете уже готовое значение.

В запросах также доступна функция РАЗНОСТЬДАТ, которая позволяет вычислить интервал между двумя датами в заданном измерении (дни, месяцы, годы). Хотя она служит для вычитания, понимание её работы помогает правильно строить логику обратного отсчета.

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

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

Типичные ошибки и способы их избегания

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

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

При работе с интервалами, кратными году, помните о смещении дней недели. Если событие должно происходить строго в определенный день недели (например, "каждый второй вторник"), простое прибавление 7 или 14 дней может сбиться, если исходная дата была выбрана некорректно.

⚠️ Внимание: Интерфейсы конфигураций и поведение некоторых функций могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3 и новее). Всегда сверяйте синтаксис с официальной документацией для вашей конкретной версии платформы, особенно если вы поддерживаете старые конфигурации.

Используйте отладчик для проверки граничных значений. Прогоните свой алгоритм на датах 31 декабря, 28 февраля и 1 января. Это выявит 90% потенциальных ошибок логики.

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

Да, можно. Платформа 1С интерпретирует дробную часть числа как долю суток. Значение 1.5 добавит к дате одни сутки и 12 часов. Это может быть полезно для расчетов с точностью до часа, но требует осторожности при сравнении дат, так как время также изменится.

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

Результатом будет последний день февраля (28-е или 29-е число). Функция ДобавлениеМесяца автоматически корректирует дату, если в целевом месяце нет соответствующего дня. Она не выдаст ошибку, а вернет максимально возможную дату этого месяца.

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

Напрямую в языке запросов функции ДобавлениеМесяца нет. Рекомендуется вычислить новую дату в программном коде 1С перед запуском запроса и передать её как параметр. Альтернативный, но менее надежный способ — использование сложных выражений с функцией ДАТАВРЕМЯ, извлекая компоненты года и месяца.

Влияет ли часовой пояс на сложение дат?

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