При разработке отчетов и обработок на платформе 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").
Резюме: что выбрать?
- Просто вывести название месяца в отчете/запросе: Используйте
ФОРМАТ(ПолеДаты, "ДФ=MMMM"). Это самый быстрый, читаемый и правильный способ с точки зрения локализации (падежи). - Нужен номер месяца для группировки/сортировки: Используйте
МЕСЯЦ(ПолеДаты). - Нужен список месяцев без привязки к данным: Сгенерируйте массив на клиенте/сервере через цикл с
ДАТАВРЕМЯ(2002, Номер, 1)и передайте в запрос как временную таблицу. - Сложная логика (например, финансовый год, смена падежей): Вынесите логику в общий модуль (функцию
МесяцПрописью) и вызывайте из запроса.
Использование стандартной функции ФОРМАТ с форматной строкой «ДФ=MMMM» является стандартом де-факто в экосистеме 1С для решения данной задачи.