Как определить текущую дату в запросах 1С: разбираемся вместе

Как часто в работе с 1С возникает необходимость получить текущую дату? Ответ очевиден - очень часто! В статье мы подробно разберем, какие есть способы определить текущую дату в запросах 1С. Эта информация будет полезна как начинающим, так и опытным пользователям системы.

Понятие даты в 1С

Дата - один из базовых типов данных в системе 1С. Она представляет собой информацию о конкретном дне, месяце и годе. Внутри платформы 1С дата хранится в виде строки фиксированной длины из 10 символов в формате "ДД.ММ.ГГГГ". Например, текущая дата 11 ноября 2023 года будет записана как "11.11.2023".

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

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

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

На практике дата чаще всего используется для:

Фильтрации данных по периодам
Сортировки записей в хронологическом порядке
Группировки и анализа данных по датам
Расчета возраста, стажа и других периодов времени

Дата в запросах 1С

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

Для удобства в язык запросов 1С включены специальные функции для работы с датой:

ТекущаяДата() - возвращает текущую дату и время
ДатаВремя() - позволяет создать дату из отдельных компонентов
Год(), Месяц(), День() - извлекают части даты
ДобавитьКДате() - прибавляет к дате интервал

Эти функции часто используются в условиях запросов для фильтрации данных по датам. Например:

 ВЫБРАТЬ Документ.ЧекККМ ИЗ Документ.ЧекККМ КАК ЧекККМ ГДЕ Год(ЧекККМ.Дата) = 2022

Такой запрос отберет все чеки ККМ за 2022 год.

При использовании даты в запросах из кода программы на 1С часто приходится передавать значения дат в виде параметров:

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

В примере выше фильтруются приходные накладные за текущий месяц.

Текущая дата в запросах 1С

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

В программном интерфейсе 1С есть готовая функция ТекущаяДата(), которая возвращает дату и время на компьютере пользователя:

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

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

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

Этот прием позволяет использовать текущую дату в различных условиях запроса:

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

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

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

Пустая и произвольная дата в запросах

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

Пустая дата в 1С представляет собой 01.01.0001 и обычно указывает на отсутствие значения даты. Чтобы проверить на пустую дату, достаточно сравнить с этим значением:

 Запрос.Текст = "ВЫБРАТЬ Документ.РасчетнаяВедомость ИЗ Документ.РасчетнаяВедомость КАК РасчетнаяВедомость ГДЕ РасчетнаяВедомость.ДатаВыплаты = ДАТАВРЕМЯ(1, 1, 1)";

Такой запрос отберет расчетные ведомости с незаполненной датой выплаты зарплаты.

Для задания в запросе произвольной даты используется функция ДатаВремя():

 ДатаВремя(2023, 11, 5) // 05.11.2023 0:00:00 ДатаВремя(2022, 12, 31, 23, 59, 59) // 31.12.2022 23:59:59

Это позволяет гибко формировать нужные диапазоны дат для отбора данных, например:

 Запрос.Текст = "ВЫБРАТЬ Документ.ЗаказПоставщику ИЗ Документ.ЗаказПоставщику КАК ЗаказПоставщику ГДЕ ЗаказПоставщику.Дата МЕЖДУ &ДатаС И &ДатаПо"; НачалоМесяца = ДатаВремя(2023, 11, 1); КонецМесяца = ДатаВремя(2023, 11, 30, 23, 59, 59); Запрос.УстановитьПараметр("ДатаС", НачалоМесяца); Запрос.УстановитьПараметр("ДатаПо", КонецМесяца);

Оптимизация запросов с датами

При написании запросов с использованием дат стоит учитывать ряд рекомендаций для повышения производительности:

Использовать индексированные поля дат
Избегать функций в условиях фильтрации
Выносить вычисления с датами в переменные
Ограничивать диапазоны дат разумными пределами

Также полезно заранее определять требуемые отрезки времени, например:

 НачалоДня = НачалоДня(ТекущаяДата()); НачалоМесяца = НачалоМесяца(ТекущаяДата()); КонецКвартала = КонецКвартала(ТекущаяДата());

Это izka-xeazaevyase использовать для фильтрации в запросах.

Дата в запросах отчетов

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

Часто в отчеты добавляют параметры типа дата, например, "За период с" и "по":

 &НачалоПериода = ДатаВремя(2022, 1, 1); &КонецПериода = ДатаВремя(2022, 6, 30, 23, 59, 59);

Это позволяет пользователю гибко указывать произвольный отчетный период.

Также для отбора данных можно использовать системные переменные:

 &Период = Период.Месяц; // текущий месяц &ДатаНач = НачалоПериода(&Период); &Период = Период.Год; // текущий год &ДатаНач = НачалоПериода(&Период);

Это позволяет, например, строить отчеты за месяц или год.

При группировке данных также удобно использовать даты:

 ВЫБРАТЬ СуммаПродаж КАК Сумма, День(ДокументПродажи.Дата) КАК День ИЗ Документ.ДокументПродажи КАК ДокументПродажи СГРУППИРОВАТЬ ПО День(ДокументПродажи.Дата)

Это позволит получить суммы продаж по дням. Аналогично можно сгруппировать по месяцам, кварталам и т.д.

Лилия Шевчук 12 ноября, 2023