Как определить количество дней между датами в 1С

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

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

Как 1С хранит даты и почему вычитание даёт секунды

Тип «Дата» в 1С всегда содержит и календарную дату, и время с точностью до секунды. Даже если в документе отображается только «12.03.2026», внутри хранится значение вида 12.03.2026 0:00:00. Это принципиально для расчётов: разность двух дат вычисляется как разность моментов времени.

При вычитании одной даты из другой результатом является число — количество секунд между двумя моментами. Например, разность между 15.03.2026 0:00:00 и 10.03.2026 0:00:00 равна 432000, то есть 5 суток, умноженных на 86400 секунд. Чтобы получить привычные дни, результат нужно разделить на 86400.

Из-за хранения времени возникает частая проблема: если в дате окончания стоит время 23:59:59, а не 00:00:00, деление даст дробное число. Поэтому перед расчётом даты часто приводят к началу дня функцией НачалоДня() или к концу дня функцией КонецДня(), в зависимости от логики задачи.

Способ 1: вычитание дат и деление на 86400

Самый прямой способ — арифметика с датами. Код выглядит так:

ДнейМежду = (ДатаОкончания - ДатаНачала) / 86400;

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

ДнейМежду = Цел((НачалоДня(ДатаОкончания) - НачалоДня(ДатаНачала)) / 86400);

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

ДнейМежду = Цел((НачалоДня(ДатаОкончания) - НачалоДня(ДатаНачала)) / 86400);

Способ 2: функция РазностьДат

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

КоличествоДней = РазностьДат(ДатаНачала; ДатаОкончания; ДЕНЬ);

Третий параметр задаёт единицу измерения и принимает значения перечисления типа единицы измерения времени: СЕКУНДА, МИНУТА, ЧАС, ДЕНЬ, МЕСЯЦ, КВАРТАЛ, ГОД. Функция возвращает целое число — сколько полных единиц указанного типа укладывается между датами.

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

Способ 3: расчёт в запросе через РАЗНОСТЬДАТ

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

ВЫБРАТЬ
Заказ.Ссылка КАК Заказ,
РАЗНОСТЬДАТ(Заказ.Дата, &ТекущаяДата, ДЕНЬ) КАК ДнейСМоментаЗаказа
ИЗ
Документ.ЗаказПокупателя КАК Заказ

Третий параметр аналогично принимает единицы: СЕКУНДА, МИНУТА, ЧАС, ДЕНЬ, МЕСЯЦ, ГОД. Результат — целое число полных единиц. Если первая дата больше второй, функция вернёт отрицательное значение.

Практический приём: результаты РАЗНОСТЬДАТ удобно использовать в отборе через конструкцию ГДЕ или ИМЕЮЩИЕ, например чтобы выбрать документы старше 30 дней. Также функцию часто комбинируют с ДОБАВИТЬКДАТЕ — обратной операцией, которая прибавляет к дате заданное количество единиц времени.

Прибавление дней к дате: ДобавитьКДате и простая арифметика

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

ДатаОплаты = ДатаДокумента + 10 * 86400; // плюс 10 дней

Более читаемый вариант — функция ДобавитьКДате():

ДатаОплаты = ДобавитьКДате(ДатаДокумента; ДЕНЬ; 10);

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

Как учитывать границы периода: включать ли первый и последний день

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

Типовые варианты постановки задачи:

• разность между датами (сколько дней прошло): (Дата2 - Дата1) / 86400, без поправки;
• длительность периода с включением обеих границ (например, отпуск с 1 по 14 число): разность плюс один день;
• просрочка: разность между текущей датой и датой срока, отрицательные значения отбрасываются или трактуются как «срок не наступил».

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

Проверка результата и типичные ошибки

Проверить корректность расчёта проще всего на контрольном примере с очевидным ответом: возьмите даты, разность между которыми известна заранее (например, 01.01 и 11.01 — ровно 10 дней), и прогоните через свою функцию. Затем проверьте граничные случаи: одинаковые даты, даты с разным временем, переход через конец месяца и високосный февраль.

Наиболее распространённые ошибки при расчёте дней между датами:

Отдельная ловушка — пустые даты. Если один из реквизитов не заполнен, его значение равно '00010101', и разность даст огромное число дней. Перед расчётом всегда проверяйте заполненность дат функцией ЗначениеЗаполнено() или сравнением с пустой датой, а в запросах — отбором ГДЕ.

Рабочие и календарные дни: ограничения простых способов

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

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

Частые вопросы