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

Другое · 7 мин

Получение номера месяца в 1С: способы и проверка

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

В 1С номер месяца чаще всего нужен для группировки отчётов, расчёта периодов, формирования выплат и сравнения дат. Источником может быть документ, регистр накопления, справочник или переменная типа Дата.

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

Результат возвращается как число от 1 до 12, где 1 — январь, 12 — декабрь. Перед использованием важно убедиться, что исходная дата корректна и не пуста, иначе функция может вернуть неопределённое значение или ошибку.

Встроенная функция Месяц в модуле

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

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

Дата из строки и нестандартный формат

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

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

Порядок получения месяца в модуле
  1. 1
    Убедитесь, что реквизит имеет тип Дата и заполнен
  2. 2
    Вызовите функцию Месяц(Дата) и сохраните результат в переменную типа Число
  3. 3
    Проверьте результат на пустую дату и границы месяца

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

Язык запросов: операция МЕСЯЦ

В языке запросов 1С месяц извлекается операцией МЕСЯЦ. Она применяется к полю типа Дата прямо в тексте запроса и позволяет сгруппировать данные по месяцам без дополнительного перебора записей в коде. Это удобно при работе с регистрами накопления, документами и остатками.

Запрос с группировкой по МЕСЯЦ(Date) возвращает набор, где каждая строка соответствует отдельному месяцу. Можно добавить условие отбора по году, чтобы не смешивать данные разных лет с одинаковыми номерами месяцев.

Отбор по текущему месяцу

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

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

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

Встроенная функция Месяц

Подходит для модулей форм и отчётов, требует заполненной даты

Язык запросов МЕСЯЦ

Удобен для отбора и группировки больших наборов данных, менее гибок в сложной логике

Отбор и группировка по месяцу в отчётах

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

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

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

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

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

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

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

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

Значение месяца
Норма

Целое число от 1 до 12

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

Пустое значение, ошибка или число вне диапазона

Исходная дата
Норма

Заполнена и имеет тип Дата

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

Пустая дата или некорректный формат

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

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

Другая ошибка — сравнение номера месяца со строкой. Номер возвращается как число, поэтому сравнение с текстом может привести к ошибке типа или неверному результату. Приводите значения к одному типу перед сравнением.

Типичные ошибки
01
Применение функции к пустой дате приводит к неопределённому результату
02
Сравнение номера месяца с текстом вместо числа вызывает ошибку типа

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

Риски и безопасные правки

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

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

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

Итог

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

Используйте подходящий способ в зависимости от места расчёта, проверяйте дату на заполненность и тестируйте изменения на копии базы.

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

Что делать, если дата пустая?

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

Нужно ли указывать год вместе с номером месяца?

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

Можно ли получить месяц из текстовой даты?

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

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

В модуле функция Месяц удобна для работы с отдельными объектами и формами, а в языке запросов операция МЕСЯЦ подходит для массовой группировки и отбора данных из регистров и документов.

Безопасно ли править отчёты самостоятельно?

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