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

Другое · 6 мин

Как из даты выделить месяц в 1С

Выделить месяц из даты в 1С можно функцией Месяц, а название месяца — через Формат. Разбор для запросов, форм и отчётов с примерами и проверкой результата.

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

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

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

В модулях объектов, форм и обычных приложений достаточно вызвать встроенную функцию: Месяц(ДатаДокумента). Результат — число, которое можно сохранить в переменную, использовать в условиях или вывести в табличную часть. Если дата не определена, поведение зависит от контекста, поэтому перед вызовом целесообразно проверить значение через Определено(Дата).

Сценарий: заполнение реквизита в форме документа

Пользователь вводит дату документа, а программа должна автоматически проставить месяц в отдельное поле. В обработчике изменения даты вычисляется Месяц(ТекущаяДата) и записывается в реквизит типа число. После этого форма перезаписывает поле, и пользователь видит подтверждение выбранного периода.

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

Как получить название месяца текстом

Для отчётов и печатных форм часто удобнее показать «Январь» или «Янв», а не число. Функция Формат(Дата, \"МММ\") даёт сокращённое название, а Формат(Дата, \"ММММ\") — полное. Код формата применяется к значению даты, а не к текущей дате сервера, поэтому месяц берётся именно из переданного документа или периода.

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

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

Месяц(Дата)

Подходит для расчётов, фильтров и группировок по номеру месяца

Формат(Дата, "МММ") / "ММММ"

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

НачалоМесяца(Дата)

Нужно, если требуется граница периода, а не только номер месяца

Работа с месяцем в запросах и отчётах

В языке запросов 1С месяц извлекается функцией МЕСЯЦ, например: ВЫБОР МЕСЯЦ(Регистратор.Дата) КАК Месяц. Это удобно для группировки продаж, остатков или движений по месяцам без ручного перебора дат. Если нужно сравнивать месяцы в разных годах, добавляйте год отдельно, иначе одинаковые номера месяцев будут смешивать разные периоды.

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

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

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

Результат Месяц(Дата)
Норма

Целое число от 1 до 12 для корректной даты

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

Ошибка, пустое значение или неопределённый результат при некорректной дате

Формат(Дата, "МММ")
Норма

Текстовое название на языке интерфейса

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

Пустая строка или неожидаемый язык при смене пользователя

Проверка результата и границы безопасной работы

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

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

Частые ошибки и ограничения

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

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

Типичные ошибки
01
Сравнение номера месяца со строкой вместо числа приводит к неверным условиям.
02
Использование текущей даты вместо даты документа
03
Смешивание месяцев разных лет без учёта года в группировке

Безопасные правки и когда обращаться к разработчику

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

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

Итог

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

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

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

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

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

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

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

Зависит ли название месяца от языка пользователя?

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

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

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