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

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

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

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

Базовая арифметика и функция ДобавлениеДаты

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

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

Рассмотрим пример использования. Если вам нужно найти дату, наступившую через месяц и 5 дней от сегодняшнего дня, вы напишете следующий код:

ТекущаяДата = ТекущаяДата();

НоваяДата = ДобавлениеДаты(ТекущаяДата, 5, 1, 0, 0, 0, 0);


// Где параметры: Секунды, Минуты, Часы, Дни, Месяцы, Годы

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

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

⚠️ Внимание: При добавлении месяцев к дате, которая является последним числом месяца (например, 31-е), результат может сместиться на последний день следующего месяца, даже если в нем больше дней. Например, 31 января + 1 месяц = 28 (или 29) февраля, а не 31 марта.

Тип данных Период: Сложение интервалов

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

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

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

СрокПоставки = Новый Период(10, 0); // 10 дней, 0 месяцев

ДатаЗаказа = '20260101';


ДатаПолучения = ДобавлениеДаты(ДатаЗаказа, 0, 0, 0, СрокПоставки.Дни, СрокПоставки.Месяцы, 0);

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

  • 📅 Тип Период позволяет хранить длительность до 1000 лет.
  • ⏱️ Поддерживает точность до секунд при хранении интервалов.
  • 🔢 Позволяет выполнять операцию сложения двух периодов для получения суммарной длительности.

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

Ограничения типа Период

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

Сложение дат в запросах 1С

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

В тексте запроса вы можете динамически рассчитывать даты прямо в операторе ВЫБРАТЬ. Это позволяет фильтровать документы или рассчитывать плановые показатели без необходимости выгружать все данные в память программы и обрабатывать их в цикле, что существенно повышает производительность.

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

ВЫБРАТЬ

Документ.Ссылка,


Документ.Дата,


ДАТАВРЕМЯДОБАВИТЬ(Документ.Дата, ДЕНЬ, 5) КАК ДатаПлюс5Дней


ИЗ


Документ.РеализацияТоваровУслуг КАК Документ


ГДЕ


Документ.Проведен = ИСТИНА

Функция ДАТАВРЕМЯДОБАВИТЬ в запросах принимает три основных параметра: исходную дату, тип периода (секунда, минута, час, день, месяц, год, квартал) и количество добавляемых единиц. Обратите внимание, что название периода указывается без кавычек как ключевое слово.

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

Тип периода Ключевое слово в запросе Пример использования
Секунда СЕКУНДА ДАТАВРЕМЯДОБАВИТЬ(Дата, СЕКУНДА, 30)
День ДЕНЬ ДАТАВРЕМЯДОБАВИТЬ(Дата, ДЕНЬ, 10)
Месяц МЕСЯЦ ДАТАВРЕМЯДОБАВИТЬ(Дата, МЕСЯЦ, 1)
Квартал КВАРТАЛ ДАТАВРЕМЯДОБАВИТЬ(Дата, КВАРТАЛ, 1)
Год ГОД ДАТАВРЕМЯДОБАВИТЬ(Дата, ГОД, 5)
📊 Какой способ работы с датами вы используете чаще?
Встроенный язык 1С
Язык запросов
Консоль запросов
Регулярные выражения

Работа с временем и секундными интервалами

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

Если вам нужно добавить 2 часа 30 минут к времени начала встречи, вы можете указать это в параметрах функции. Платформа автоматически учтет переход через полночь. Например, если встреча назначена на 23:00, то прибавление 2 часов перенесет её на 01:00 следующего дня.

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

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

ВремяНачала = '20260520140000'; // 20 мая 14:00

ДлительностьЧасы = 3;


ВремяОкончания = ДобавлениеДаты(ВремяНачала, 0, 0, ДлительностьЧасы, 0, 0, 0);


// Результат: 20 мая 17:00

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

💡

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

Нюансы високосных лет и календаря

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

Если вы добавите один год к дате 29.02.2026, результатом будет 28.02.2026, так как в 2026 году февраля 29 дней не существует. Платформа автоматически выполняет эту корректировку, предотвращая ошибки выполнения.

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

  • 🗓️ Високосный год наступает каждые 4 года, за исключением вековых лет, не делящихся на 400.
  • 🔄 Функция ДобавлениеДаты автоматически "схлопывает" несуществующие даты на последний день месяца.
  • ⚠️ При расчете возраста или стажа важно учитывать, что 29 февраля + 1 год = 28 февраля.

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

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

💡

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

Частые ошибки и лучшие практики

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

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

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

Используйте константы для часто повторяющихся интервалов. Если в вашей системе часто встречается срок "45 дней", объявите это как константу в модуле менеджера. Это упростит изменение бизнес-логики в будущем: вам нужно будет поменять значение только в одном месте.

// Плохая практика

НоваяДата = ДобавлениеДаты(СтараяДата, 0, 0, 0, 45, 0, 0);



// Хорошая практика


СрокОплатыВДнях = 45;


НоваяДата = ДобавлениеДаты(СтараяДата, 0, 0, 0, СрокОплатыВДнях, 0, 0);

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

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

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

Вопросы и ответы (FAQ)

Можно ли вычесть одну дату из другой в 1С?

Да, при вычитании одной даты из другой (Дата1 - Дата2) результатом будет число, равное количеству секунд между этими датами. Для получения разницы в днях это число нужно разделить на 86400 (количество секунд в сутках).

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

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

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

В языке запросов используйте ключевое слово КВАРТАЛ. Пример: ДАТАВРЕМЯДОБАВИТЬ(ДатаПоля, КВАРТАЛ, 1). Во встроенном языке 1С нет отдельного параметра "Квартал", нужно добавлять 3 месяца.

Почему при сложении дат получается некорректное время?

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

Как получить первый день месяца от текущей даты?

Используйте функцию НачалоМесяца(ТекущаяДата()). Это стандартная функция платформы, которая возвращает дату, соответствующую первому дню месяца указанной даты, с временем 00:00:00.