1С: дата начала месяца в коде и запросе

НачалоМесяца и КонецМесяца в 1С

НачалоМесяца() возвращает первое число месяца в 00:00:00, КонецМесяца() — последний момент последнего дня. Обе функции принимают значение типа Дата и возвращают Дата.

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

Сообщить(Формат(Начало, "ДФ=dd.MM.yyyy HH:mm:ss"));
Сообщить(Формат(Конец, "ДФ=dd.MM.yyyy HH:mm:ss"));

Для даты 15.04.2025 результат НачалоМесяца() равен 01.04.2025 00:00:00. Значение КонецМесяца() удобно для показа пользователю, но в условиях выборки безопаснее использовать начало следующего месяца как исключающую верхнюю границу.

Предыдущий и следующий месяц через ДобавитьМесяц

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

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

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

НачалоСледующего = ДобавитьМесяц(НачалоТекущего, 1);
КонецСледующего = КонецМесяца(НачалоСледующего);

1С запрос: начало месяца через НАЧАЛОПЕРИОДА

Если начало месяца нужно получить для каждой строки выборки, используйте функцию языка запросов НАЧАЛОПЕРИОДА(Дата, МЕСЯЦ). Это отличается от встроенного языка: в запросе применяется НАЧАЛОПЕРИОДА, а не НачалоМесяца.

ВЫБРАТЬ
    НАЧАЛОПЕРИОДА(Реализация.Дата, МЕСЯЦ) КАК Месяц,
    СУММА(Реализация.СуммаДокумента) КАК Сумма
ИЗ
    Документ.РеализацияТоваровУслуг КАК Реализация
ГДЕ
    НЕ Реализация.ПометкаУдаления
СГРУППИРОВАТЬ ПО
    НАЧАЛОПЕРИОДА(Реализация.Дата, МЕСЯЦ)

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

Фильтр запроса полуинтервалом: >= начало и < следующий месяц

Надёжный месячный отбор — полуинтервал [НачалоПериода, НачалоСледующегоПериода). Он включает все события первого дня и исключает первый момент следующего месяца.

НачалоПериода = НачалоМесяца(ДатаОтчета);
НачалоСледующегоПериода = ДобавитьМесяц(НачалоПериода, 1);

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

Запрос.УстановитьПараметр("НачалоПериода", НачалоПериода);
Запрос.УстановитьПараметр("НачалоСледующегоПериода", НачалоСледующегоПериода);

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

Часовые пояса и границы месяца

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

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

1С: формат даты в строку функцией Формат

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

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

ДатаДляПользователя = Формат(Начало, "ДФ=dd.MM.yyyy");
ДатаДляОбмена = Формат(Начало, "ДФ=yyyy-MM-dd'T'HH:mm:ss");
МесяцДляИмениФайла = Формат(Начало, "ДФ=yyyy-MM");

В маске даты регистр важен: MM — месяц, mm — минуты, HH — часы. Текстовый формат не добавляет сведения о часовом поясе автоматически.

Пустая дата и проверка входных значений

Пустая дата в 1С — значение Дата(1, 1, 1). Если применить к ней НачалоМесяца(), получится та же календарная граница, что обычно не имеет бизнес-смысла. Проверяйте необязательный реквизит до расчёта периода.

ПустаяДата = Дата(1, 1, 1);

Если ЗначениеЗаполнено(ДатаОтчета) И ДатаОтчета <> ПустаяДата Тогда
    НачалоПериода = НачалоМесяца(ДатаОтчета);
    НачалоСледующегоПериода = ДобавитьМесяц(НачалоПериода, 1);
Иначе
    ВызватьИсключение "Не указана дата отчета";
КонецЕсли;

При форматировании пустой даты учитывайте параметр ДП форматной строки: он управляет её представлением. Не подменяйте отсутствие даты пустой строкой до завершения вычислений.

Частые ошибки при расчёте начала месяца в 1С

• Отбор через <= КонецМесяца(). Для границы данных надёжнее использовать < НачалоСледующегоМесяца.
• Сдвиг исходного 29–31 числа. Перед ДобавитьМесяц() сначала вызовите НачалоМесяца().
• НачалоМесяца() внутри текста запроса. В языке запросов функция называется НАЧАЛОПЕРИОДА(Дата, МЕСЯЦ).
• Сравнение даты со строкой. Формат() возвращает строку; в запрос передавайте параметр типа Дата.
• Путаница MM и mm. В форматной строке это месяц и минуты соответственно.
• Разные часовые пояса границ. Нижняя и верхняя границы должны быть рассчитаны и преобразованы одинаково.
• Расчёт периода от пустой даты. Сначала проверяйте заполненность входного значения.

Частые вопросы о начале месяца в 1С