Момент времени в 1С: что это и как с ним работать

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

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

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

Из чего состоит момент времени

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

Такое устройство решает фундаментальную задачу учётной системы: движения по регистрам должны накапливаться в строго определённом порядке. Если бы упорядочивание шло только по дате, документы с одинаковым временем могли бы меняться местами, и остатки «на документ» стали бы непредсказуемыми. Ссылка как второй компонент гарантирует стабильный порядок.

В языке запросов момент времени представлен виртуальным полем МоментВремени, доступным у документов и у записей регистров, подчинённых регистратору. Встроенный тип «МоментВремени» также существует как самостоятельный объект, который можно создать конструктором Новый МоментВремени(Дата, Ссылка).

Зачем платформе нужен момент времени

Основное применение — расчёт остатков и оборотов регистров на конкретную границу. Когда отчёт строится «на документ», платформе нужно знать, включать движения этого документа в итог или нет. Именно момент времени задаёт эту границу: виртуальные таблицы остатков принимают его как параметр периодичности.

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

Третья задача — корректное сравнение документов в коде и запросах. Сравнение «документ А раньше документа Б» через простые даты ненадёжно: при совпадении секунд результат не определён. Сравнение моментов времени даёт однозначный ответ.

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

У объекта документа момент времени доступен через свойство МоментВремени. У ссылки на документ момент времени напрямую не хранится — его получают либо через объект, либо запросом, либо создают конструктором, если дата известна.

// Получение момента времени через объект документа
ДокОбъект = ДокументСсылка.ПолучитьОбъект();
Момент = ДокОбъект.МоментВремени;

// Создание момента времени вручную
Момент = Новый МоментВремени(ДокументСсылка.Дата, ДокументСсылка);

// Сравнение моментов времени
Если ДокОбъект1.МоментВремени < ДокОбъект2.МоментВремени Тогда
	// Документ 1 расположен раньше на временной оси
КонецЕсли;

Обратите внимание: конструктор Новый МоментВремени(Дата, Ссылка) корректно работает, только если переданная дата совпадает с фактической датой документа. Если документ после получения момента времени перепровели со сменой даты, сохранённое ранее значение устареет.

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

Момент времени в запросах

В языке запросов поле МоментВремени есть у таблиц документов и у таблиц регистров, подчинённых регистратору. Через него удобно упорядочивать выборку и отбирать записи до или после конкретного документа.

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Остатки.Номенклатура,
|	Остатки.КоличествоОстаток
|ИЗ
|	РегистрНакопления.ТоварыНаСкладах.Остатки(&МоментВремени, ) КАК Остатки";
Запрос.УстановитьПараметр("МоментВремени", ДокументОбъект.МоментВремени);

Есть тонкость: при передаче момента времени в виртуальную таблицу остатков движения самого документа-границы в результат включаются или не включаются в зависимости от того, как платформа обрабатывает границу, и это поведение нужно проверять на тестовых данных конкретной конфигурации. Если нужна граница строго «до документа», часто используют объект типа «Граница» с видом «Исключая».

Для упорядочивания записей регистра по времени внутри одной секунды сортировки по полю Период недостаточно — добавляйте в упорядочивание МоментВремени или Регистратор.

Момент времени и граница: в чём разница

Рядом с моментом времени в платформе существует тип «Граница». Граница — это момент времени плюс признак включения: «Включая» или «Исключая». Она уточняет, попадает ли сам объект-граница в выборку.

Типичный сценарий использования границы — метод регистра ВыбратьДвиженияСОстатками, который возвращает движения документа вместе с остатками на заданную границу. Передав границу «Исключая», вы получите остатки до движений документа, что часто нужно при контроле остатков в обработке проведения.

Типичные ошибки при работе с моментом времени

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

Как проверить корректность логики

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

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

FAQ