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

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

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

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

Основная функция Месяц() в языке запросов

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

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

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

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

Обратите внимание, что в предложении СГРУППИРОВАТЬ ПО мы также используем функцию Месяц(). Это обязательное требование языка запросов: все неагрегированные поля в списке выбора должны присутствовать в группировке. Если вы забудете добавить функцию в группировку, система выдаст ошибку компиляции запроса.

Работа с датой во встроенном языке 1С

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

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

Пример кода на встроенном языке демонстрирует простоту обращения:

ТекущаяДата = ТекущаяДата();
НомерМесяца = ТекущаяДата.Месяц;

Сообщить("Сейчас идет " + НомерМесяца + "-й месяц года");

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

⚠️ Внимание: Свойство Месяц доступно только для объектов типа Дата. Если переменная имеет тип Строка или Неопределено, попытка обращения к свойству вызовет ошибку выполнения. Всегда проверяйте тип данных перед обращением.

Преобразование строки в дату для извлечения месяца

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

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

Рассмотрим безопасный алгоритм получения номера месяца из строки:

• 📅 Сначала попытайтесь преобразовать строку в дату с помощью функции Дата().
• 🛡️ Оберните операцию преобразования в конструкцию Попытка..Исключение для перехвата ошибок формата.
• 🔢 В случае успеха извлеките свойство .Месяц из полученного объекта даты.
• ❌ В блоке исключения обработайте ситуацию некорректных данных, например, запишите ошибку в журнал регистрации.

Использование конструкции Попытка гарантирует, что ваша программа не «упадет» при получении некорректных данных от пользователя или внешней системы. Это важный аспект написания устойчивого кода, который может работать в реальных условиях эксплуатации.

Сравнительная таблица методов работы с месяцем

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

Контекст использования	Метод / Функция	Возвращаемый тип	Особенности
Язык запросов	Месяц(Дата)	Число	Используется в SELECT, WHERE, GROUP BY
Встроенный язык	Дата.Месяц	Число	Свойство объекта, работает быстро
Форматная строка	Формат(Дата, "ЧН=02")	Строка	Возвращает строку с ведущим нулем (01, 02..)
Конструктор даты	Дата(Год, Месяц, 1)	Дата	Создает дату начала месяца по номеру

Как видно из таблицы, если вам нужно отобразить номер месяца пользователю с ведущим нулем (например, "05" вместо "5"), использование свойств или функций запроса потребует дополнительного форматирования. В этом случае на помощь приходит функция Формат(), которая позволяет гибко управлять представлением числовых значений.

Также стоит отметить, что использование конструктора Дата(Год, Месяц, 1) является обратным действием: вы создаете дату, зная номер месяца. Это часто требуется при программном создании периодов для отчетов или при итерации по месяцам в цикле.

Расчет периодов и границы месяцев

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

В платформе 1С существуют специальные функции НачалоМесяца(), КонецМесяца(), НачалоКвартала() и другие. Они часто используются в связке с функцией Месяц(). Например, чтобы получить последний день текущего месяца, можно воспользоваться функцией КонецМесяца(ТекущаяДата()), не прибегая к сложным вычислениям.

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

Если Месяц(ДатаДокумента) = Месяц(Сеанс.РабочаяДата) И
Год(ДатаДокумента) = Год(Сеанс.РабочаяДата) Тогда

Сообщить("Документ относится к текущему месяцу");

КонецЕсли;

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

Почему опасно сравнивать только номера месяцев?

Если вы сравниваете только свойство.Месяц, то 15 января 2023 и 15 января 2026 будут считаться одинаковыми. Всегда проверяйте и Год(), чтобы избежать ошибок в отчетах за разные периоды.

⚠️ Внимание: При работе с переходом через год (декабрь -> январь) простые арифметические операции с номером месяца (например, Месяц + 1) могут дать неверный результат (13 вместо 1). Используйте функции ДобавитьМесяц() для корректного перехода через границу года.

Типичные ошибки и способы их устранения

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

Другая частая ошибка связана с типизацией данных. В слабых типизированных переменных 1С легко перепутать число 12 (номер месяца) и дату. При попытке передать число в функцию, ожидающую дату, или наоборот, система может вести себя непредсказуемо. Всегда явно приводите типы данных, если в этом есть сомнения.

Список основных проблем, с которыми сталкиваются программисты:

• 🚫 Попытка вызвать метод .Месяц у значения Неопределено, что вызывает критическую ошибку.
• 📅 Игнорирование високосных годов при ручном расчете количества дней в месяце вместо использования встроенных функций.
• 🕒 Различия во времени сервера и клиента при определении «текущего» месяца в тонком клиенте.

Для избежания проблем с високосными годами никогда не жестко задавайте количество дней в месяце (28, 30, 31). Используйте функцию КонецМесяца(), которая автоматически учитывает все календарные особенности, включая високосные годы и реформы календаря.

Оптимизация запросов при группировке по месяцам

При работе с большими объемами данных производительность запросов становится критическим фактором. Использование функций в условиях ГДЕ или в полях группировки может влиять на использование индексов. Хотя функция Месяц() оптимизирована в платформе 1С, существуют нюансы, которые стоит учитывать при проектировании высоконагруженных систем.

Если вы часто фильтруете данные по месяцам, убедитесь, что по полю даты, которое вы используете, построен индекс. В большинстве стандартных конфигураций индекс по полю Период или МоментВремени уже существует. Однако, если вы вычисляете месяц «на лету» для каждой строки таблицы перед фильтрацией, это может увеличить нагрузку на сервер баз данных.

Рекомендуется использовать диапазоны дат вместо вычисления функции для каждой строки, если это возможно. Например, вместо условия Месяц(Дата) = 5, эффективнее указать диапазон:

ГДЕ
Продажи.МоментВремени >= НАЧАЛОПЕРИОДА(2026, 05, 01) И
Продажи.МоментВремени < НАЧАЛОПЕРИОДА(2026, 06, 01)

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

Часто задаваемые вопросы (FAQ)

Как получить название месяца (Январь, Февраль) вместо номера?

Для получения строкового названия месяца используйте функцию Формат(). Пример: Формат(ТекущаяДата(), "ДФ=MMMM") вернет полное название месяца на языке интерфейса пользователя, а "ДФ=МММ" — сокращенное.

Можно ли использовать функцию Месяц() в условиях соединения (JOIN)?

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

Что вернет функция Месяц(), если передать ей пустую дату?

Передача некорректного значения или значения Неопределено в функцию Месяц() в запросе приведет к ошибке выполнения запроса. В коде 1С обращение к свойству .Месяц пустой даты также вызовет исключение.

Как получить номер предыдущего месяца автоматически?

Используйте функцию ДобавитьМесяц(Дата, -1), а затем возьмите свойство .Месяц от результата. Это корректно обработает переход через январь (вернет 12 для декабря предыдущего года).