К статье
Практический материал

Другое · 8 мин

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

Как получить первое число месяца в 1С: встроенная функция НачалоМесяца, варианты в запросах и отчётах, проверка результата и типичные ошибки при работе с датами.

В 1С:Предприятии начало месяца обычно нужно для отборов по периодам, расчёта начислений, формирования отчётов и закрытия расчётных периодов. Под этим понимается первое число месяца с обнулённым временем: 00:00:00, независимо от времени, которое было в исходной дате.

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

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

Получение начала месяца в модуле 1С

В коде на встроенном языке достаточно вызвать НачалоМесяца и передать в неё дату из документа, регистра или реквизита формы. Пример: НачалоМесяца(Документ.Дата) вернёт первое число месяца документа, независимо от дня и времени создания документа.

Если нужно получить начало текущего месяца, передайте ТекущаяДата(): НачалоМесяца(ТекущаяДата()). Это удобно для отборов «с начала месяца по сегодня» или для сравнения дат с границей текущего отчётного периода.

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

Порядок действий в модуле
  1. 1
    Убедитесь, что исходное поле имеет тип Дата и заполнено
  2. 2
    Вызовите НачалоМесяца(ИсходнаяДата)
  3. 3
    Используйте результат в отборе, расчёте или записи в реквизит
  4. 4
    Проверьте, что день результата равен 1, а время — 00:00:00

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

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

Получение начала месяца в запросе 1С

В языке запросов начало месяца можно получить с помощью функций работы с датами или конструктора даты. Один из вариантов — составить дату из компонентов исходного значения: Дата(Год(Дата), Месяц(Дата), 1). Это даёт первое число месяца в 00:00:00.

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

Запрос с вычислением начала месяца удобен для отбора движений регистров, остатков на начало месяца и turnover-аналитики. При этом вычисление в каждом запросе может увеличивать нагрузку, поэтому для массовых отчётов стоит подумать о предварительном расчёте границ периода.

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

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

Проверка результата и границы применения

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

Функция НачалоМесяца не изменяет исходную дату, а возвращает новое значение. Исходный реквизит остаётся без изменений, если вы не запишете результат обратно явно. Это важно при работе с документами, где дата должна оставаться исходной.

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

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

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

Типичные ошибки и ограничения

Одна из частых ошибок — передача в НачалоМесяца значения типа Строка без приведения к Дате. В этом случае функция может вернуть неопределённое значение или вызвать ошибку приведения типов, особенно в строгом режиме компиляции.

Вторая ошибка — игнорирование времени. Даже если день равен 1, но время не обнулено, сравнение с другими датами может дать неожиданные результаты. Начало месяца всегда должно иметь время 00:00:00.

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

Сравнение вариантов

НачалоМесяца в модуле

Подходит для кода, форм и отчётов; требует типа Дата на входе.

Конструктор Дата(Год, Месяц, 1)

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

Начало периода в запросе

Подходит для отборов на уровне базы; точный синтаксис зависит от версии платформы.

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

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

Альтернативы и выбор способа

Когда нужно работать только в запросе, вычислите границу периода на стороне базы и передайте её в отбор. Это уменьшает объём передаваемых данных и упрощает отладку. В модулях удобнее использовать НачалоМесяца напрямую.

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

Если компания использует некалендарные отчётные периоды, функция НачалоМесяца может быть неприменима без доработки. В этом случае нужно опираться на реквизиты периода из справочника или регистра сведений, а не вычислять границу по календарю.

Контрольные точки

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

День результата
Норма

Равен 1

Тревожный признак

Другой день месяца

Месяц и год
Норма

Совпадают с исходной датой

Тревожный признак

Смещены на другой месяц или год

Время
Норма

00:00:00

Тревожный признак

Есть ненулевое время

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

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

Итог

Что важно запомнить

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

Что возвращает НачалоМесяца, если дата уже является первым числом месяца?

Функция вернёт ту же дату, но с обнулённым временем: 00:00:00 первого числа. Месяц и год не меняются, день остаётся равным единице.

Можно ли передать в НачалоМесяца дату в виде строки?

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

В чем разница между функцией в модуле и началом периода в запросе?

Функция используется в коде на встроенном языке, а начало периода в запросе — на уровне языка запросов при формировании выборки. Выбор зависит от места вычисления: в модуле удобнее функция, в отборе запроса — языковые средства запроса.

Как убедиться, что результат действительно является началом месяца?

Проверьте, что день равен 1, месяц и год совпадают с исходной датой, а время равно 00:00:00. Если хотя бы один признак не соблюдается, значение не подходит в качестве границы месяца.