Оператор КОГДА в запросе 1С: синтаксис, примеры и нюансы

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

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

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

Синтаксис и базовое назначение оператора

Оператор КОГДА в языке запросов 1С служит аналогом условия сравнения для полей типа Дата или Время. Его базовая структура напоминает стандартное математическое условие равенства или неравенства, но с учетом специфики временных шкал. В теле запроса он обычно располагается в блоке ГДЕ или ИМЕЮЩИЕ, определяя критерии отбора строк результирующей выборки. Правильное использование синтаксиса гарантирует, что система корректно интерпретирует намерения разработчика.

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

⚠️ Внимание: При написании запросов вручную в консоли или модуле объекта убедитесь, что переменные, подставляемые в условие КОГДА, инициализированы до выполнения метода Выполнить(). Пустая ссылка на дату может привести к выбору всех записей или ошибке выполнения.

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

Сравнение дат и работа с временными интервалами

Чаще всего оператор КОГДА используется не для поиска точного совпадения до секунды, а для определения попадания даты в определенный интервал. В таких случаях он комбинируется с операторами сравнения: >=, <=, >, <. Это позволяет формировать выборки за период, например, "с начала месяца по текущую дату". Такой подход является стандартом при построении оборотно-сальдовых ведомостей и других регламентированных отчетов.

При работе с интервалами критически важно понимать разницу между включением и исключением граничных значений. Если вам нужно получить данные за весь день 31 декабря, условие Дата >= НачалоДня('31.12.2023') И Дата < КонецДня('31.12.2023') будет наиболее корректным. Использование строгого равенства КОГДА в сочетании с функциями времени требует особой внимательности к форматам данных.

• 📅 Для выбора данных за текущий месяц используйте конструкцию с НачалоПериода и КонецПериода.
• ⏳ При сравнении учитывайте, что тип Дата включает в себя и дату, и время, даже если время не отображается в интерфейсе.
• 🔍 Оператор КОГДА чувствителен к часовым поясам при работе с распределенными базами данных или веб-сервисами.

Особое внимание следует уделить функции СЕГОДНЯ() и ТЕКУЩАЯДАТА(). Первая возвращает дату без времени (начало суток), а вторая — точный момент времени. Если вы используете их в условии с оператором КОГДА, результат выборки может кардинально отличаться. Например, условие Дата КОГДА СЕГОДНЯ() выберет только документы, созданные ровно в 00:00:00 текущего дня, что обычно не является желаемым поведением.

Использование параметров и переменных в условиях

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

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

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Документ.Ссылка
|ИЗ Документ.РеализацияТоваровУслуг КАК Документ
|ГДЕ Документ.Дата КОГДА &Период";
Запрос.УстановитьПараметр("Период", ТекущаяДата());
Результат = Запрос.Выполнить();

В приведенном примере параметр &Период подставляется в условие КОГДА. Обратите внимание на использование символа амперсанда для обозначения параметра в тексте запроса. Это стандартный синтаксис платформы, который нельзя нарушать. Также стоит отметить, что имя параметра регистронезависимо, но для читаемости кода рекомендуется соблюдать единый стиль написания.

Типичные ошибки и логические ловушки

Одной из самых распространенных ошибок при использовании оператора КОГДА является игнорирование временной составляющей типа Дата. Многие разработчики полагают, что запись с датой "25.10.2023 14:30" равна дате "25.10.2023". Однако с точки зрения машины это разные значения. Условие Дата КОГДА '25.10.2023' (где время неявно 00:00:00) не выполнится для документа, созданного днем.

Другая частая проблема возникает при работе с нулевыми датами. В 1С существует концепция пустой даты, которая может вести себя непредсказуемо в условиях сравнения. Если поле в базе данных не заполнено, сравнение его с любой конкретной датой через оператор КОГДА вернет Ложь. Для обработки таких случаев необходимо явно проверять значение на пустоту или использовать функцию ЕСТЬNULL().

Сценарий	Ошибочный код	Корректное решение
Выбор за весь день	Дата КОГДА &Дата	Дата >= НачалоДня(&Дата) И Дата < КонецДня(&Дата)
Проверка на заполненность	Дата КОГДА НЕ NULL	НЕ ЕСТЬNULL(Дата)
Сравнение без времени	Дата КОГДА &ДатаБезВремени	НачалоДня(Дата) КОГДА НачалоДня(&Дата)

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

⚠️ Внимание: Избегайте применения функций преобразования даты непосредственно к полям таблицы в условии отбора. Это отключает использование индексов по дате и может замедлить работу системы в десятки раз на больших базах данных.

Оптимизация запросов с оператором КОГДА

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

Для ускорения выборки рекомендуется сужать диапазон данных как можно раньше. Если вы знаете, что вас интересуют данные только за текущий год, добавьте соответствующее условие с оператором КОГДА или диапазоном в самый начало блока ГДЕ. Это позволит механизму СУБД (SQL Server, PostgreSQL или встроенному) сразу отсечь огромные пласты неактуальной информации, не загружая их в оперативную память.

• 🚀 Используйте составные индексы, если фильтрация идет одновременно по дате и другому часто используемому полю (например, Контрагент).
• 📉 Избегайте конструкций НЕ (Дата КОГДА..), так как они часто менее эффективны, чем прямое указание нужных диапазонов.
• ⚙️ Проверяйте план выполнения запроса через консоль отладки, чтобы убедиться, что условия по дате используются для индексного доступа.

Еще одним аспектом оптимизации является работа с виртуальными таблицами. В типовых конфигурациях 1С многие регистры имеют специальные срезы и остатки, которые уже оптимизированы для выбора данных на конкретную дату. Использование оператора КОГДА к таким виртуальным таблицам (например, РегистрНакопления.ОстатыНа( &Дата )) часто внутренне преобразуется платформой в наиболее эффективный SQL-код.

Секрет высокой производительности

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

Продвинутые техники: динамические периоды и сдвиги

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

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

Рассмотрим пример получения данных за аналогичный период прошлого года. Это частая задача для сравнительного анализа продаж. Мы можем вычислить дату начала и конца периода прошлого года в коде и передать их в запрос, где оператор КОГДА (в виде диапазона) отсечет нужные записи. Такой подход гарантирует, что логика расчета периода едина для всего приложения и не дублируется в разных местах.

// Пример расчета периода прошлого года
ДатаНачала = ДобавитьГод(НачалоГода(ТекущаяДата()), -1);
ДатаКонца = ДобавитьГод(КонецГода(ТекущаяДата()), -1);

Запрос.Текст = "ВЫБРАТЬ.. ГДЕ Дата >= &Нач И Дата <= &Кон";
Запрос.УстановитьПараметр("Нач", ДатаНачала);
Запрос.УстановитьПараметр("Кон", ДатаКонца);

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

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

Почему запрос с условием "Дата КОГДА Сегодня()" не возвращает документы, созданные сегодня днем?

Функция Сегодня() возвращает дату с временем, равным 00:00:00. Документы, созданные в течение дня, имеют время больше нуля. Для выбора всех документов за сегодня используйте диапазон: Дата >= НачалоДня(Сегодня()) И Дата < НачалоДня(Сегодня() + 1).

Можно ли использовать оператор КОГДА для полей типа "Время"?

Да, оператор КОГДА универсален и работает с любыми типами данных, поддерживающими сравнение, включая тип Время. Синтаксис остается прежним, но значения должны быть в формате времени (например, 12:30:00).

Как правильно сравнить дату в запросе, если в базе хранятся разные часовые пояса?

В рамках одной базы 1С все даты хранятся в локальном времени сервера или клиента (в зависимости от настроек). Проблемы с часовыми поясами возникают при обмене с внешними системами. В таком случае необходимо приводить дату к единому стандарту (например, UTC) перед установкой параметра в операторе КОГДА.

Что вернет условие "Дата КОГДА NULL"?

В языке запросов 1С сравнение с NULL через оператор равенства всегда возвращает Неизвестно (что трактуется как Ложь в условии отбора). Для проверки на пустое значение используйте конструкцию ЕСТЬNULL(Дата) или Дата ЕСТЬ NULL в зависимости от версии платформы, но предпочтительнее функция ЕСТЬNULL.

Влияет ли формат даты в коде (ДД.ММ.ГГГГ vs ГГГГ-ММ-ДД) на работу оператора?

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