Работа с датами в запросе в 1С

Как получить дату в запросе

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

Второй вариант — взять дату из поля выборки. Третий — собрать ее из числовых значений с помощью функции ДАТАВРЕМЯ().

Именно функция ДАТАВРЕМЯ() используется, когда дату и время нужно задать прямо в тексте запроса. Если передать в нее шесть чисел, можно указать значение с точностью до секунды. Если задать только год, месяц и день, время автоматически будет равно `00:00:00`, то есть началу дня.

Например, чтобы выбрать документы за первые десять дней января 2018 года, условие может выглядеть так:

 ВЫБРАТЬ
    ПоступлениеНаРасчетныйСчет.Ссылка КАК Ссылка
ИЗ
    Документ.ПоступлениеНаРасчетныйСчет КАК ПоступлениеНаРасчетныйСчет
ГДЕ
    ПоступлениеНаРасчетныйСчет.Дата МЕЖДУ ДАТАВРЕМЯ(2018, 1, 1, 0, 0, 0) И ДАТАВРЕМЯ(2018, 1, 10, 23, 59, 59) 

Как проверить пустую дату

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

 ДАТАВРЕМЯ(1, 1, 1) 

С этим значением сравнивают поле или переменную. Такой способ считается самым простым и понятным.

Основные функции для работы с датами

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

НАЧАЛОПЕРИОДА

Функция возвращает начало указанного периода. Если нужно убрать время и получить дату на начало дня, во втором параметре указывают ДЕНЬ.

НАЧАЛОПЕРИОДА(<Дата>, <Период>)
НАЧАЛОПЕРИОДА(&Дата, ДЕНЬ) 

КОНЕЦПЕРИОДА

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

ДОБАВИТЬКДАТЕ

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

ДОБАВИТЬКДАТЕ(<Дата>, <Тип>, <Количество>)
ДОБАВИТЬКДАТЕ(&Дата, ДЕНЬ, 10) 

РАЗНОСТЬДАТ

Вычисляет разницу между двумя датами в нужных единицах измерения.

РАЗНОСТЬДАТ(<Дата1>, <Дата2>, <Тип>)
РАЗНОСТЬДАТ(&Дата1, &Дата2, ДЕНЬ) 

ДЕНЬНЕДЕЛИ

Функция возвращает порядковый номер дня недели. На ее основе можно получить текстовое название дня через конструкцию ВЫБОР.

ВЫБОР

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 1

        ТОГДА"понедельник"

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 2

        ТОГДА"вторник"

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 3

        ТОГДА"среда"

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 4

        ТОГДА"четверг"

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 5

        ТОГДА"пятница"

    КОГДАДЕНЬНЕДЕЛИ(&ТекущаяДата) = 6

        ТОГДА"суббота"

    ИНАЧЕ"Воскресенье"

КОНЕЦ

Когда лучше использовать параметр

Преобразование даты из строки или числа прямо в запросе обычно требует дополнительных действий. Из чисел дату еще можно собрать через ДАТАВРЕМЯ, а со строками все сложнее: приходится использовать ПОДСТРОКА и конструкцию ВЫБОР КОГДА ТОГДА ИНАЧЕ. Поэтому на практике дату чаще подготавливают в модуле и уже потом передают в запрос параметром.

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

Вывод

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

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