Зачем работать с датами в запросах
Работа программиста 1С нередко связана с обработкой дат. Функция ДОБАВИТЬКДАТЕ — это один из мощных инструментов запросов, который приходит на помощь в таких ситуациях. Вам приходилось фильтровать документы по времени, вычислять дедлайны и проверять сроки исполнения? Все эти задачи легче решаются с её помощью. Она позволяет прибавлять или вычитать дни, месяцы и другие интервалы времени прямо в тексте запроса. Нет нужды вручную считать секунды или учитывать високосные годы — укажите дату, нужную единицу измерения и количество, а система всё посчитает за вас.
Когда пригодится ДОБАВИТЬКДАТЕ
Представьте, что нужно найти все заказы, дата которых старше одного года, или расчитать срок задания, добавив две недели к дате начала. Возможно, требуется получить список клиентов, зарегистрированных пять лет назад, или определить последний день месяца для отчёта. Такие задачи в 1С возникают сплошь и рядом, и ДОБАВИТЬКДАТЕ идеально подходит именно для них. Вместо сложных вычислений и конвертации единиц вы просто задаёте интервал в запросе. Например, можно решать задачи вроде:
- получить документы за последние 30 дней;
- найти заказы с оплатой более месяца назад;
- вычислить дату через полгода от текущей.
К счастью, всё это сделать очень просто — нужно только знать про функцию ДОБАВИТЬКДАТЕ.
Синтаксис функции ДОБАВИТЬКДАТЕ
Функция ДОБАВИТЬКДАТЕ принимает три аргумента:
- Дата — исходная дата (поле таблицы или параметр типа Дата).
- Тип — единица измерения времени: СЕКУНДА, МИНУТА, ЧАС, ДЕНЬ, НЕДЕЛЯ, ДЕКАДА, МЕСЯЦ, КВАРТАЛ, ПОЛУГОДИЕ или ГОД.
- Количество — число указанных единиц (целое). Может быть отрицательным (чтобы отнять время).
Если передать только дату и число без типа, 1С поймет это как дни. То есть ДОБАВИТЬКДАТЕ(Дата, 7) прибавит 7 дней.
Кстати: в 1С единица ДЕКАДА означает десять дней, а ПОЛУГОДИЕ — шесть месяцев. Кажется забавно, но эта подробность действительно может пригодиться! Видите, сколько вариантов? Значит, не нужно самим выяснять, сколько там месяцев или дней в периоде — всё уже учтено.
Пример запроса с ДОБАВИТЬКДАТЕ
Напишем запрос, который покажет номер заказа, саму дату заказа и дату через один месяц после заказа:
Запрос.Текст = "ВЫБРАТЬ ЗаказПокупателя.Номер КАК Номер, ЗаказПокупателя.Дата КАК ДатаЗаказа, ДОБАВИТЬКДАТЕ(ЗаказПокупателя.Дата, МЕСЯЦ, 1) КАК ДатаЧерезМесяц ИЗ Документ.ЗаказПокупателя КАК ЗаказПокупателя";
Запрос вернёт таблицу с тремя колонками: Номер заказа, Дата заказа и ДатаЧерезМесяц. И всё — никаких дополнительных вычислений! Функция ДОБАВИТЬКДАТЕ сама учтет длинные и короткие месяцы, високосные годы и не подведёт вас. Это действительно удобно.
Использование параметров и отрицательных чисел
В запрос можно передать параметры, например дату. Покажем, как вычесть 10 дней от текущей даты:
Запрос = Новый Запрос; Запрос.Текст = "ВЫБРАТЬ ДОБАВИТЬКДАТЕ(&НачальнаяДата, ДЕНЬ, -10) КАК ДатаМинус10"; Запрос.УстановитьПараметр("НачальнаяДата", ТекущаяДата()); Результат = Запрос.Выполнить().Выбрать();
Этот код передаёт параметр &НачальнаяДата (сегодняшнюю дату) и прибавляет к ней -10 дней. То есть функция вычтет 10 дней. Очень удобно: нам не нужно делать лишних вычислений или искать количество секунд в неделе.
Практические советы для работы с ДОБАВИТЬКДАТЕ
Запомните: поле или параметр Дата должно быть именно типа Дата. Обычно это поле Дата документа или результат вызова ТекущаяДата(). Если тип не тот, запрос не сработает.
Когда пишете запрос вручную, проверяйте синтаксис: 1С чувствительна к пробелам, запятым и кавычкам. Любая ошибка в параметрах выдаст уведомление.
Кстати, многие новички сначала стремятся сделать всё через сложные формулы. Но стоит один раз попробовать ДОБАВИТЬКДАТЕ, и обычные расчёты кажутся неуклюжими. В работе с запросами важно писать лаконично и правильно. Например, вместо того чтобы высчитывать, сколько секунд в трёх днях (259200!), можно просто написать ДОБАВИТЬКДАТЕ(Дата, ДЕНЬ, 3). Просто и понятно.
Поддержка и помощь специалистов
Если вы только начинаете работать с 1С или столкнулись с нетиповой задачей, обратитесь к профессионалам. Компания MoscowSoft – партнёр фирмы 1С с 2019 года и аккредитованная ИТ-компания с 2023 года – обладает богатым опытом в автоматизации. В её портфеле более 60 программных продуктов из реестра российского ПО. Специалисты MoscowSoft помогут вам разработать даже самый сложный запрос и проконсультируют по любым вопросам. Кстати, если вы очень заняты рутинной работой, они возьмут её на себя, чтобы вы смогли сосредоточиться на главном. Компания MoscowSoft может помочь вам с этой задачей и с любыми другими вопросами по 1С.
Дальнейшая отладка запросов
Функция ДОБАВИТЬКДАТЕ — обязательный инструмент в арсенале начинающего 1С-разработчика. С её помощью можно легко добавлять и вычитать периоды: дни, месяцы, кварталы или даже годы. Практикуйтесь: попробуйте получить заказы старше 90 дней или запланировать события через четыре месяца. Это быстро поможет вам отладить запрос.
Теперь вы знаете, как упростить работу с датами в запросах. Главное — помнить синтаксис и проверять условия. А если задачи станут сложнее, помните про MoscowSoft, который поможет с любым вопросом по 1С. Итак, готовы ли вы использовать эту функцию или продолжите всё рассчитывать вручную?
