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

Как вывести название месяца прописью прямо в SQL-запросе 1С:Предприятие 8? Разбираем функцию ФОРМАТ и другие хитрости — просто, наглядно, с кодом!

Бесплатная консультация юриста

+7 (800) 302-87-29

Реклама jurik.ru

При разработке отчетов и обработок на платформе 1С:Предприятие 8 часто возникает задача вывести название месяца прописью (например, «Январь», «Февраль») прямо в тексте SQL-запроса к базе данных. В данной статье подробно разбираются все основные способы решения этой задачи: от использования встроенной функции ФОРМАТ до создания вспомогательных функций на языке 1С.

Способ 1: Использование функции ФОРМАТ (Рекомендуемый)

Наиболее простой и нативный способ получить название месяца в запросе — использовать функцию ФОРМАТ(Значение, ФорматнаяСтрока). Для получения полного названия месяца используется форматная строка ДФ=MMMM (или просто ДФММММ в сокращенной записи свойств поля, но в тексте запроса пишется явно).

Базовый синтаксис

ВЫБРАТЬ
 ФОРМАТ(МояДата, "ДФ=MMMM") КАК НазваниеМесяца
ИЗ
 МояТаблица

Пример с текущей датой:

ВЫБРАТЬ ФОРМАТ(ТЕКУЩАЯДАТА, "ДФ=MMMM")

Результат (если сейчас март): Март

Пример с жестко заданной датой:

ВЫБРАТЬ ФОРМАТ(ДАТАВРЕМЯ(2015, 8, 20), "ДФ=MMMM")

Результат: Август

Получение «Месяц Год» (например, «Октябрь 2019 г.»)

Часто требуется вывести месяц и год вместе. Для этого расширяем форматную строку:

ВЫБРАТЬ ФОРМАТ(ТЕКУЩАЯДАТА, "ДФ=MMMM yyyy 'г.'")

Результат: Октябрь 2019 г.

Важно: Функция ФОРМАТ автоматически ставит корректное падежное окончание названия месяца (родительный падеж: «Январь», «Февраль», «Март»…), что является большим преимуществом перед ручным перебором массива строк.

Способ 2: Получение номера месяца (Функции МЕСЯЦ и ДАТАМЕСЯЦ)

Если вам нужен не текст, а числовой номер месяца (1–12), в языке запросов есть две функции:

  • МЕСЯЦ(Дата) — возвращает номер месяца года для указанной даты.
  • ДАТАМЕСЯЦ(Дата), синоним функции МЕСЯЦ, возвращает порядковый номер месяца.
ВЫБРАТЬ
 МЕСЯЦ(Документ.Дата) КАК НомерМесяца,
 ДАТАМЕСЯЦ(Документ.Дата) КАК НомерМесяцаАльтернатива
ИЗ
 Документ.РеализацияТоваровУслуг

Способ 3: Алгоритмическое получение названия без привязки к реальной дате

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

Проблема: Конструктор ДАТАВРЕМЯ(Год, Месяц, День) требует корректные значения. Год 0001 для января в некоторых конфигурациях может давать пустую дату (нулевую).

Решение: Использовать год 2002 (или любой другой високосный/обычный год, где все месяцы существуют).

Пример кода на встроенном языке (для заполнения значений параметров запроса):

// Заполняем массив или список значений названиями месяцев
МассивМесяцев = Новый Массив;

Для СчМ = 1 По 12 Цикл
 // Формируем дату: 2002 год, текущий месяц, 1 число
 ДатаДляФормата = ДАТАВРЕМЯ(2002, СчМ, 1);
 // Получаем название через Формат
 Название = ФОРМАТ(ДатаДляФормата, "ДФ=MMMM");
 МассивМесяцев.Добавить(Название);
КонецЦикла;

// Теперь МассивМесяцев содержит: "Январь", "Февраль", ... "Декабрь"

Этот массив можно передать в запрос как временную таблицу или использовать в параметрах СКД.

Способ 4: Вспомогательная функция «МесяцПрописью» (Для использования в модулях)

Если логика сложная и выносится в общий модуль, удобно обернуть форматирование в функцию:

Функция МесяцПрописью(НомерМесяца) Экспорт
 
 // Проверка корректности номера
 Если НомерМесяца < 1 ИЛИ НомерМесяца > 12 Тогда
 Возврат "";
 КонецЕсли;
 
 // Используем фиктивную дату (год 2002 гарантированно корректен)
 ДатаДляФормата = ДАТАВРЕМЯ(2002, НомерМесяца, 1);
 
 Возврат ФОРМАТ(ДатаДляФормата, "ДФ=MMMM");
 КонецФункции

Вызов в запросе (если функция определена в общем модуле с клиентским/серверным вызовом):

ВЫБРАТЬ МесяцПрописью(МЕСЯЦ(Дата)) КАК НазваниеМесяца
ИЗ Справочник.Номенклатура

Дополнительные полезные функции для работы с датами в запросах

При работе с месяцами часто требуются смежные операции:

Функция Описание Пример
ДОБАВИТЬКДАТЕ(Дата, ПЕРИОД, Значение) Добавляет к дате указанное количество периодов (МЕСЯЦ, ДЕНЬ, ГОД и т.д.) ДОБАВИТЬКДАТЕ(ТЕКУЩАЯДАТА, МЕСЯЦ, 1), следующий месяц
РАЗНОСТЬДАТ(Дата1, Дата2, ПЕРИОД) Возвращает разность между датами в указанных единицах РАЗНОСТЬДАТ(НачалоМесяца, КонецМесяца, ДЕНЬ)
НАЧАЛОПЕРИОДА(Дата, МЕСЯЦ) Возвращает дату начала месяца (01.ММ.ГГГГ 00:00:00) НАЧАЛОПЕРИОДА(Дата, МЕСЯЦ)
КОНЕЦПЕРИОДА(Дата, МЕСЯЦ) Возвращает дату конца месяца (последний день 23:59:59) КОНЕЦПЕРИОДА(Дата, МЕСЯЦ)
КВАРТАЛ(Дата) / ДАТАКВАРТАЛ(Дата) Возвращает номер квартала (1-4) для даты Для вернет 1

Особенности использования в СКД (Система компоновки данных)

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

  • В тексте запроса СКД: Используйте ФОРМАТ(Дата, "ДФ=MMMM").
  • В свойствах поля (оформление): Можно задать формат вывода даты через свойство Форматная строка: ДФ=MMMM (полное название) или ДФ=MM (номер месяца с ведущим нулем).
  • В вычисляемом поле СКД (язык 1С): Формат(Дата, "ДФ=MMMM").

Резюме: что выбрать?

  1. Просто вывести название месяца в отчете/запросе: Используйте ФОРМАТ(ПолеДаты, "ДФ=MMMM"). Это самый быстрый, читаемый и правильный способ с точки зрения локализации (падежи).
  2. Нужен номер месяца для группировки/сортировки: Используйте МЕСЯЦ(ПолеДаты).
  3. Нужен список месяцев без привязки к данным: Сгенерируйте массив на клиенте/сервере через цикл с ДАТАВРЕМЯ(2002, Номер, 1) и передайте в запрос как временную таблицу.
  4. Сложная логика (например, финансовый год, смена падежей): Вынесите логику в общий модуль (функцию МесяцПрописью) и вызывайте из запроса.

Использование стандартной функции ФОРМАТ с форматной строкой «ДФ=MMMM» является стандартом де-факто в экосистеме 1С для решения данной задачи.