К статье
Практический материал

Другое · 7 мин

Как рассчитать дату в 1С:Предприятии

Расчёт дат в 1С: текущая дата, прибавление дней и месяцев, начало и конец периода, разность между датами, проверка результата и типичные ошибки.

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

Основные операции: получение текущей даты, прибавление или вычитание дней, месяцев и лет, выделение компонентов даты, определение начала или конца периода, подсчёт разности между двумя датами. Для большинства расчётов достаточно стандартных возможностей встроенного языка, без написания сложных алгоритмов.

Перед расчётом важно уточнить, где будет выполняться код: на клиенте, на сервере или в мобильном приложении, а также какой датой считать текущую — датой сессии пользователя, датой сервера или датой из реквизита документа. Разница может изменить результат на несколько часов или даже суток.

Как получить текущую дату и задать дату вручную

Текущая дата обычно берётся из системы выполнения: на сервере это дата сервера, на клиенте — дата рабочей станции пользователя, если не указано иное. Для фиксированных значений дату составляют из компонентов: года, месяца и дня, при необходимости добавляя часы, минуты и секунды.

Если дата поступает из документа или справочника, используйте значение реквизита напрямую, а не подменяйте его текущей датой. Это особенно важно для проводок, отгрузок и начислений, где дата документа должна соответствовать реальному событию, а не моменту запуска обработки.

Когда текущая дата может быть не той

Отличия возникают при работе в разных часовых поясах, смене системных часов на клиенте или выполнении фоновых заданий на сервере. В распределённых базах дата сервера может не совпадать с локальной датой пользователя, поэтому для критческих расчётов явно фиксируйте, какой источник даты считается эталонным.

Прибавление и вычитание дней, месяцев и лет

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

Если расчёт ведётся в рабочих днях, простое прибавление календарных дней не подходит: потребуется производственный календарь с учётом выходных и праздников. Без календаря результат будет календарным, а не рабочим, что может привести к ошибке в сроках.

Разница между календарным и рабочим сроком

Календарный срок считает все дни подряд, включая субботы, воскресенья и праздники. Рабочий срок исключает нерабочие дни и требует актуального производственного календаря для соответствующей территории. Проверьте, какой срок подразумевается в задании, прежде чем приступать к расчёту.

Порядок расчёта даты
  1. 1
    Определите исходную дату и источник её получения
  2. 2
    Выберите направление расчёта: вперёд или назад
  3. 3
    Укажите интервал: дни, месяцы или годы
  4. 4
    Выполните расчёт и при необходимости обнулите время
  5. 5
    Сравните результат с ожидаемым диапазоном

Выделение компонентов даты: день, месяц, год, квартал, неделя

Из значения типа Дата можно получить отдельные компоненты: номер дня, месяц, год, квартал, день недели или номер недели. Это полезно для группировки отчётов по месяцам, определения отчётного периода или проверки принадлежности даты к текущему году.

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

Начало и конец дня, месяца, квартала, года

Границы периода часто нужны для отборов в запросах и отчётах: начало дня — 00:00:00, конец дня — 23:59:59 или следующее начало минус одна секунда, начало месяца — первое число, конец месяца — последнее число месяца. Аналогично определяются границы квартала и года.

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

Типичные ошибки
01
Использование текущей даты вместо даты документа для проводок
02
Забывание о времени суток при сравнении дат
03
Смешивание календарных и рабочих дней без производственного календаря
04
Неверная граница периода при отборе в отчёте

Разность между датами и сроки

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

Если даты находятся в разных часовых поясах или имеют разное время суток, разность в днях может дать неожиданный результат. Перед расчётом приведите даты к одному представлению: например, к началу дня, если время не имеет значения.

Контрольные точки

Как проверить результат

Результат прибавления дней
Норма

Дата сдвинута на ожидаемое число календарных дней

Тревожный признак

Дата сдвинута на другое число или изменилось время неочевидно

Граница месяца или года
Норма

Первое или последнее число периода совпадает с календарём

Тревожный признак

Попали лишние или не попали нужные документы

Разность между датами
Норма

Количество дней соответствует разности календарных дат

Тревожный признак

Результат отличается из-за времени суток или часового пояса

Где безопасно менять даты и ограничения

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

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

Итог

Что важно запомнить

В 1С дату считают стандартными средствами встроенного языка с учётом источника даты, места выполнения кода и границ периода. Проверяйте время суток, рабочие дни и закрытые периоды перед применением результата.

Как получить текущую дату в 1С?

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

Как прибавить месяц к дате?

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

Нужно ли учитывать время при расчёте даты?

Да, если тип Дата хранит время, два значения с одинаковым календарным днём, но разным временем, будут разными. Для сравнения только по календарному дню приведите обе даты к началу дня или обнулите время перед расчётом.

Что делать, если дата в отчёте не совпадает с ожидаемой?

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