Как из даты получить дни в 1С

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

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

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

Получение номера дня месяца функцией День()

Самая простая задача — вытащить из даты число месяца. Для этого служит функция День(), которая принимает значение типа Дата и возвращает целое число от 1 до 31.

ДатаДокумента = Дата(2026, 3, 15);
НомерДня = День(ДатаДокумента); // результат: 15

Функция корректно обрабатывает концы месяцев и високосные годы: для 29 февраля она вернёт 29, для 31 декабря — 31. Никаких дополнительных проверок писать не нужно.

Если день нужен в строковом виде с лидирующим нулём (например, для формирования номера документа или имени файла), используйте функцию Формат():

СтрокаДня = Формат(ДатаДокумента, "ДФ=dd"); // "05" для 5 марта

Обратите внимание: Формат() возвращает строку, а не число. Если результат потом участвует в арифметике, преобразуйте его обратно через Число(), иначе получите ошибку сложения строки с числом.

День недели и день года

Определение дня недели

Функция ДеньНедели() возвращает число от 1 до 7, где 1 — понедельник, 7 — воскресенье. Это соответствует российской привычке считать неделю с понедельника, но отличается от некоторых зарубежных систем, где неделя начинается с воскресенья.

Если ДеньНедели(ТекущаяДата()) >= 6 Тогда
Сообщить("Это выходной день");
КонецЕсли;

Такая проверка часто используется при расчёте сроков оплаты, дат доставки, планировании задач. Если нужно название дня недели строкой, применяйте Формат(Дата, "ДФ=dddd") — вернётся «понедельник», «вторник» и т.д. с учётом региональных настроек.

Порядковый день в году

Функция ДеньГода() возвращает порядковый номер дня с начала года — от 1 до 365 (или 366 в високосном году). Она удобна для расчётов, привязанных к годовым циклам: нормы выработки, графики ТО, сезонные коэффициенты.

НомерДняВГоду = ДеньГода(Дата(2026, 12, 31)); // 366 для високосного года

Количество дней между двумя датами

Вычитание двух дат во встроенном языке даёт результат в секундах, а не в днях. Это частая причина ошибок у начинающих разработчиков. Чтобы получить дни, результат делят на число секунд в сутках — 86400.

РазностьВСекундах = ДатаОкончания - ДатаНачала;
КоличествоДней = Цел(РазностьВСекундах / 86400);

Здесь есть тонкость: если в датах задано время, разность может быть не кратна суткам. Например, между 10:00 понедельника и 18:00 вторника — 1,33 суток. Функция Цел() отбросит дробную часть, что не всегда желательно. Если нужно считать именно календарные дни без привязки ко времени, предварительно обрежьте время функцией НачалоДня():

КоличествоДней = (НачалоДня(ДатаОкончания) - НачалоДня(ДатаНачала)) / 86400;

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

РАЗНОСТЬДАТ в языке запросов

Когда дни нужно вычислить для большого набора данных — например, просрочку по тысяче документов, — делать это в цикле после выборки нерационально. В языке запросов есть функция РАЗНОСТЬДАТ, выполняющая расчёт на стороне СУБД.

ВЫБРАТЬ
Счет.Ссылка КАК Счет,
РАЗНОСТЬДАТ(Счет.Дата, &ТекущаяДата, ДЕНЬ) КАК ДнейПросрочено
ИЗ
Документ.СчетНаОплатуПокупателю КАК Счет
ГДЕ
НЕ Счет.Оплачен

Первые два параметра — начальная и конечная даты, третий — единица измерения: СЕКУНДА, МИНУТА, ЧАС, ДЕНЬ, МЕСЯЦ, КВАРТАЛ, ГОД. Результат — целое число полных единиц между датами.

В том же запросе можно извлечь и составные части даты: функции ДЕНЬ(Дата), МЕСЯЦ(Дата), ГОД(Дата), ДЕНЬНЕДЕЛИ(Дата), ДЕНЬГОДА(Дата) работают аналогично встроенному языку. Это удобно для группировок в отчётах, например «по дням недели» или «по числам месяца».

РазностьВДнях = (НачалоДня(Дата2) - НачалоДня(Дата1)) / 86400;

Число дней в месяце и добавление дней к дате

Сколько дней в заданном месяце

Готовой функции «количество дней в месяце» в языке нет, но она легко получается через конец месяца:

ДнейВМесяце = День(КонецМесяца(ПроизвольнаяДата));

Функция КонецМесяца() возвращает последний момент месяца (23:59:59 последнего дня), а День() извлекает из него номер последнего дня — это и есть число дней в месяце с учётом високосных лет.

Прибавление и вычитание дней

Прибавить фиксированное число дней можно простым сложением с секундами: НоваяДата = Дата + 7 * 86400. Однако для сдвига на месяцы и годы такой способ не подходит из-за разной длины месяцев. Универсальный инструмент — функция ДобавитьМесяц() для месячных сдвигов, а для дней — сложение секунд.

В запросах для сдвига дат используется функция ДОБАВИТЬКДАТЕ(Дата, ДЕНЬ, 5), которая корректно работает и с днями, и с месяцами, и с годами. Для вычитания передавайте отрицательное число.

Проверка результата и граничные случаи

После внедрения расчёта дней проверьте его на граничных значениях: переход через месяц и год, високосный февраль, даты с ненулевым временем, пустая дата. Пустая дата в 1С — это Дата(1,1,1), и День() от неё вернёт 1, что может исказить расчёты. Перед вычислениями полезно проверять заполненность: Если ЗначениеЗаполнено(ДатаНачала) Тогда ....

Отдельный риск — даты, приходящие извне: из Excel, веб-сервисов, обменов. Они могут быть в текстовом виде в неожиданном формате (американский MM/DD/YYYY вместо DD/MM/YYYY). Преобразование такой строки без контроля формата даёт перевёрнутые день и месяц, и ошибка всплывёт только на датах после 12-го числа.

Частые вопросы