Другое · 6 мин
Как получить месяц текущей даты в 1С
Получить месяц текущей даты в 1С: функция Месяц(ТекущаяДата()), где использовать, как проверить результат и избежать ошибок при работе с периодами.
В 1С:Предприятии текущая дата получается стандартной функцией, а номер месяца выделяется из неё отдельно. Это нужно при формировании отчётов, настройке фильтров, расчёте сроков и определении отчётного периода по дате документа.
Выражение ТекущаяДата() возвращает значение типа Дата, включая время. Функция Месяц(Дата) извлекает из этого значения целое число от 1 до 12. Время внутри даты не влияет на номер месяца, поэтому результат зависит только от года, месяца и дня текущей сессии информационной базы.
Важно различать номер месяца и его название. Месяц() возвращает число, поэтому сравнивать его со строкой вроде «Январь» некорректно. Текстовое представление месяца получается отдельными средствами форматирования, шаблон которых уточняется в справочнике синтаксиса для используемой версии платформы и языка интерфейса.
Где можно использовать выражение
Номер месяца востребован в модулях объектов, форм, отчётах и запросах. Например, его можно использовать для автоматического заполнения реквизита «Месяц» при создании документа, для отбора операций за текущий месяц или для динамической подписи в печатной форме.
В запросе языка встроенных выражений вычисление обычно выполняется на стороне сервера или в зависимости от контекста выполнения. Если значение нужно в клиентском модуле, убедитесь, что функция доступна в данном типе модуля и не требует дополнительных прав доступа к данным.
Как получить номер месяца
Напишите в модуле:
Месяц(ТекущаяДата())
Результат — число. Январь соответствует 1, декабрь — 12. Значение можно присвоить переменной типа Число, записать в реквизит формы или использовать в условии If. Проверка типа результата поможет избежать неявного приведения к строке.
Если нужно получить месяц не текущей, а произвольной даты, передайте эту дату в функцию Месяц(). Например, Месяц(ДатаДокумента) вернёт месяц документа, независимо от текущего дня.
Как получить название месяца
Функция Месяц() не возвращает текст «Январь» или «Февраль». Для текстового представления используйте форматирование даты, доступное в вашей конфигурации. Точный шаблон зависит от версии платформы, языка и настроек пользователя, поэтому перед использованием в отчёте проверьте результат в отладчике или консоли запросов.
Не подставляйте названия месяцев вручную через строку «01», «02» и т.д., если дальше планируется арифметика или сравнение с датами. Это усложняет поддержку и может привести к ошибкам при смене языка интерфейса.
Проверка и отладка результата
После вычисления выведите значение в сообщение пользователя или в отладчик. Убедитесь, что число соответствует календарному месяцу текущей рабочей даты информационной базы. Если результат отличается от ожидаемого, проверьте, не подменяется ли системная дата и не используется ли дата из другого сеанса.
В конфигураторе можно добавить временную форму с полем типа Число и программно записать в него Месяц(ТекущаяДата()). Если поле отображает корректное число, выражение работает. После отладки временный код рекомендуется удалить.
Ограничения и риски
Текущая дата в 1С связана с сеансом информационной базы, а не всегда с локальными часами пользователя. В распределённых базах или при работе через терминальный сервер дата может отличаться от часов на рабочем станце. Не меняйте системные часы вручную, чтобы изменить месяц: это может нарушить периоды, закрытие месяцев и целостность данных.
Номер месяца без года и дня недостаточно точен для границ периода. Для отбора «текущий месяц» лучше формировать начальную дату первого числа и конечную дату последнего числа, а не полагаться только на номер месяца. Это защищает от ошибок при переходе года и при работе с архивными периодами.
Как выбрать действие
Типичные ошибки
Сравнение результата Месяц() со строковым названием месяца приводит к неверному условию. Использование только номера месяца без года может смешать данные разных лет. Запись результата в реквизит типа Строка без приведения может вызвать неявное преобразование и проблемы при сортировке.
Ещё одна ошибка — вызов ТекущаяДата() в кажд цикле обработки большого набора документов. Если все строки должны относиться к одному отчётному месяцу, вычислите значение один раз перед циклом и переиспользуйте его.
Как проверить результат
Целое число от 1 до 12, соответствующее текущему месяцу
Ошибка выполнения, ноль, значение больше 12 или несоответствие рабочей дате
Отображается на языке пользователя и совпадает с календарём
Пустая строка, код месяца вместо названия или неверный язык
Как выбрать способ получения месяца
Если нужен порядковый номер для расчётов, фильтров и записей, используйте Месяц(ТекущаяДата()). Если нужно показать пользователю название месяца в отчёте, применяйте форматирование даты и проверяйте отображение на целевом языке интерфейса. Для отбора по границам периода вычисляйте даты начала и конца месяца, а не только его номер.
Как проверить результат
Нормальным признаком является целое число от 1 до 12, совпадающее с календарным месяцем текущей рабочей даты информационной базы. Признаком проблемы является отрицательное число, ноль, значение больше 12, несоответствие текущему месяцу или ошибка выполнения из-за некорректного аргумента.
Что важно запомнить
Месяц(ТекущаяДата()) возвращает номер месяца числом от 1 до 12. Название получается отдельно через форматирование, а периоды лучше задавать датами начала и конца месяца.
Частые вопросы
Возвращает ли Месяц() название месяца?
Нет. Функция возвращает целое число от 1 до 12. Текстовое название получается отдельно средствами форматирования даты платформы.
Можно ли использовать результат в запросе?
Да, в подходящих контекстах выполнения можно использовать функции языка в запросах или вычислять значение в модуле и передавать параметром. Точная доступность зависит от типа модуля и конфигурации.
Что делать, если месяц определяется неверно?
Проверьте рабочую дату информационной базы, часовой контекст сеанса и отсутствие ручной подмены системной даты. Убедитесь, что аргументом функции передаётся корректное значение типа Дата.
Достаточно ли номера месяца для отчёта за текущий месяц?
Не всегда. Для надёжного отбора лучше использовать дату первого числа текущего месяца и дату последнего числа, чтобы не смешать данные разных лет и не ошибиться при переходе января.