При разработке отчетов на базе системы компоновки данных (СКД) разработчики часто сталкиваются с необходимостью рассчитать интервал между двумя датами непосредственно на вкладке Вычисляемые поля. Привычные по встроенному языку конструкции вроде Дата1 - Дата2 или стандартные для языка запросов вызовы функций здесь приводят к ошибкам синтаксиса. Разберем причины такого поведения и рассмотрим корректные способы решения задачи.
Проанализируем поведение системы при попытке вычесть одну дату из другой. В программном коде 1С оператор «минус» для дат перегружен: операция Дата1 - Дата2 возвращает количество секунд между моментами времени. Однако язык выражений СКД — это отдельный диалект платформы, правила которого отличаются как от встроенного языка 1С:Предприятия, так и от языка запросов СУБД.
В языке выражений компоновки данных бинарные операторы сложения и вычитания (+ и -) строго типизированы и работают исключительно с числами. Попытка вычесть дату из даты или отнять от даты числовое значение (например, ЗаказПокупателя.Дата - 2) вызывает синтаксическую ошибку, так как система не поддерживает арифметику дат через стандартные операторы.
Для вычисления временного интервала между датами в СКД предназначена встроенная функция РАЗНОСТЬДАТ(). При переходе с языка запросов разработчики часто допускают ошибку, указывая третий параметр (период) как ключевое слово без кавычек, например: РАЗНОСТЬДАТ(ЗаказПокупателя.Дата, &ТекДата, ДЕНЬ). Это приводит к ошибке синтаксического анализа.
Главное отличие: в языке выражений СКД третий параметр функции РАЗНОСТЬДАТ обязательно должен быть строковым литералом (в двойных кавычках).
Посмотрим на корректный синтаксис выражения вычисляемого поля:
РАЗНОСТЬДАТ(ЗаказПокупателя.Дата, &ТекДата, "ДЕНЬ")
В качестве единицы измерения периода допускается указывать следующие строковые значения (регистр символов значения не имеет):
"СЕКУНДА""МИНУТА""ЧАС""ДЕНЬ""НЕДЕЛЯ""ДЕКАДА""МЕСЯЦ""КВАРТАЛ""ПОЛУГОДИЕ""ГОД"Важно помнить механизм работы функции РАЗНОСТЬДАТ: она считает количество пересечений календарных границ указанного периода, а не точный астрономический интервал. Выясним, как это проявляется на практике:
Если начальная дата равна 31.12.2023 23:59:59, а конечная — 01.01.2024 00:00:01, вызов РАЗНОСТЬДАТ(Дата1, Дата2, "ГОД") вернет 1, хотя фактически прошло всего две секунды. Аналогично для дней: пересечение полуночи добавляет единицу к результату.
Если требуется получить точное математическое количество суток или часов с дробной частью, разность следует рассчитать в секундах, а затем разделить на константу времени:
РАЗНОСТЬДАТ(ЗаказПокупателя.Дата, &ТекДата, "СЕКУНДА") / 86400
При вычислении разности дат важно учитывать наличие незаполненных реквизитов. Если одно из полей не заполнено (содержит пустую дату 0001-01-01 или значение NULL), функция вернет либо NULL, либо огромное число (разницу между началом нашей эры и текущей датой).
Для предотвращения некорректных данных в отчете используем конструкцию ВЫБОР в выражении вычисляемого поля:
ВЫБОР
КОГДА ЗаказПокупателя.Дата ЕСТЬ NULL ИЛИ ЗаказПокупателя.Дата = ДАТАВРЕМЯ(1, 1, 1)
ТОГДА 0
ИНАЧЕ РАЗНОСТЬДАТ(ЗаказПокупателя.Дата, &ТекДата, "ДЕНЬ")
КОНЕЦ
Разберем другие варианты реализации, которые можно применить в зависимости от архитектуры отчета:
РАЗНОСТЬДАТ(ЗаказПокупателя.Дата, &ТекДата, ДЕНЬ). Это снижает нагрузку на процессор компоновки данных.МойОбщийМодуль.РассчитатьРазницуДат(ЗаказПокупателя.Дата, &ТекДата). Для успешного выполнения общий модуль должен иметь признак «Сервер» (или «Клиент», если отчет формируется на клиенте), а функция должна быть объявлена с ключевым словом Экспорт.