Сколько дней в месяце: определение количества дней в 1С

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

Самый надёжный способ — получить дату конца месяца функцией КонецМесяца() и извлечь из неё номер дня функцией День(). Поскольку последний день месяца всегда равен количеству дней в нём, формула даёт точный результат для любого месяца, включая февраль високосного года. Ручные таблицы «31–28–31» при этом не нужны вообще.

Ниже разобраны рабочие варианты кода, различия между тонким и серверным контекстом, особенности запросов и типичные ошибки, из-за которых расчёт «съезжает» на день или падает с ошибкой.

Базовый способ: День(КонецМесяца(Дата))

Функция КонецМесяца(Дата) принимает значение типа Дата и возвращает дату-время последнего дня того же месяца с точностью до секунды — например, для 15.02 получится 28.02 (или 29.02 в високосном году) 23:59:59. Функция День(Дата) извлекает из даты номер дня в месяце как число.

Соединяя обе функции, получаем универсальную формулу:

Функция ДнейВМесяце(ПроверяемаяДата) Экспорт
Возврат День(КонецМесяца(ПроверяемаяДата));
КонецФункции

// Примеры вызова:
ДнейВМесяце('20260115'); // 31
ДнейВМесяце('20260210'); // 29 — високосный год
ДнейВМесяце('20230210'); // 28
ДнейВМесяце('20230405'); // 30

Такую функцию удобно разместить в общем модуле (например, «РаботаСДатами» или «ОбщегоНазначенияКлиентСервер»), чтобы вызывать её из любых процедур конфигурации. Убедитесь, что у модуля установлены нужные флаги контекста: «Сервер», «Клиент (обычное приложение)» или «Клиент (управляемое приложение)» — в зависимости от того, откуда планируется вызов.

Функция ДнейВМесяце(Дата) Экспорт
    Возврат День(КонецМесяца(Дата));
КонецФункции

Альтернативные способы расчёта

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

Функция ДнейВМесяцеЧерезДобавитьМесяц(Дата) Экспорт
НачалоТекущего = НачалоМесяца(Дата);
НачалоСледующего = ДобавитьМесяц(НачалоТекущего, 1);
Возврат (НачалоСледующего - НачалоТекущего) / 86400;
КонецФункции

Здесь 86400 — количество секунд в сутках (60 × 60 × 24). Результат вычитания двух дат в 1С — это число секунд между ними, поэтому деление обязательно. Способ чуть длиннее, но полезен, когда в той же процедуре уже вычисляются границы периодов через ДобавитьМесяц.

Третий вариант — через РазностьДат() с типом разности «День»: РазностьДат(НачалоМесяца(Дата), ДобавитьМесяц(НачалоМесяца(Дата), 1), ТипРазностиДат.День). Он читается явнее, но работает медленнее простого вычитания и на практике используется реже.

Количество дней в месяце в запросе

Когда расчёт нужен прямо в запросе — например, для отчёта по отработанным дням — используются функции языка запросов: КОНЕЦПЕРИОДА(Дата, МЕСЯЦ) и ДЕНЬ(Дата). Запрос вернёт число дней без обращения к коду модулей:

ВЫБРАТЬ
&Период КАК Дата,
ДЕНЬ(КОНЕЦПЕРИОДА(&Период, МЕСЯЦ)) КАК ДнейВМесяце

В отчётах на СКД то же выражение можно записать в вычисляемом поле на языке выражений системы компоновки, где доступны те же функции периодов. Если нужно количество дней не в месяце конкретной даты, а в произвольном периоде «с даты по дату», используйте РАЗНОСТЬДАТ(НачалоПериода, КонецПериода, ДЕНЬ) + 1 — единица добавляется, потому что РАЗНОСТЬДАТ возвращает число полных интервалов между датами, не включая первый день.

Учёт високосных лет и граничных случаев

Главное преимущество встроенных функций — автоматическая обработка високосных лет. КонецМесяца для февраля вернёт 28 или 29 число в зависимости от года, и никаких дополнительных проверок писать не нужно. Это исключает класс ошибок, типичных для самодельных таблиц «количество дней по номеру месяца», где февраль зашит константой 28.

Обратите внимание на пустую дату. Если в функцию передать значение '00010101' (пустая дата), КонецМесяца вернёт 31.01.0001, и результатом будет 31 — формально корректно, но почти наверняка не то, что ожидалось в бизнес-логике. Перед расчётом стоит проверять входное значение:

Если Не ЗначениеЗаполнено(ПроверяемаяДата) Тогда
ВызватьИсключение "Не указана дата для расчёта количества дней";
КонецЕсли;

Ещё один нюанс — тип входного значения. Если дата приходит из формы как строка, сначала преобразуйте её через Дата(Строка) или обеспечьте явный тип реквизита. Передача строки в КонецМесяца вызовет ошибку выполнения.

Практические сценарии применения

Расчёт пропорции отработанного времени

Типовая задача зарплатных конфигураций — рассчитать долю месяца, которую сотрудник отработал: принят 15 числа, уволен 20-го, больничный с середины месяца. Формула выглядит так: Доля = ОтработанныеДни / День(КонецМесяца(Период)). Полученный коэффициент умножается на оклад или тариф. В типовых решениях (ЗУП) для этого есть свои механизмы учёта времени, но в самописных расчётах формула применяется напрямую.

Формирование графика платежей

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

Проверка введённых дат в документах

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

1. 1
   Создайте или откройте общий модуль с флагом Сервер и ВызовСервера при необходимости.
2. 2
   Добавьте функцию ДнейВМесяце с проверкой на пустую дату.
3. 3
   Замените в прикладном коде константы 30/31 на вызов функции.
4. 4
   Протестируйте на датах: 31.01, 28.02 невисокосного, 29.02 високосного, 30.04.
5. 5
   Проверьте отчёты и расчёты, где раньше использовались фиксированные значения.

Проверка результата и типичные ошибки

После внедрения функции прогоните её на контрольном наборе дат: январь (31), апрель (30), февраль високосного и невисокосного года. Достаточно четырёх-пяти проверок, чтобы убедиться в корректности. В отладчике удобно смотреть промежуточное значение КонецМесяца — оно должно показывать 23:59:59 последнего дня.

Частая ошибка — забыть, что КонецМесяца возвращает не начало дня, а конец (23:59:59). Если результат сравнивается с датой документа, у которой время 00:00:00, сравнение «равно» не сработает. Для сравнений по дню используйте НачалоДня(КонецМесяца(Дата)) или сравнивайте только части даты.

Вторая распространённая проблема — смешение контекстов: функция объявлена в серверном модуле без флага «Вызов сервера», а вызывается из клиентской процедуры. Платформа выдаст ошибку «Процедура или функция с указанным именем не определена». Проверьте флаги модуля или перенесите функцию в клиент-серверный модуль.

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