Синтаксис и применение Период в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Период (Period)
Период (Period)
Тип: Дата.
Содержит период, к которому относится запись регистра.
Методическая информация
Практические примеры
Увидеть приход и расход до свёртки в итоги
Основная таблица показывает каждую активную запись с направлением и положительным количеством.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
В отдельной учебной конфигурации создайте документ УчебноеДвижение с разрешённым проведением и автонумерацией. Реквизиты: Артикул (Строка 20), Количество (Число 15.3), Приход (Булево), Комментарий (Строка 100).
Создайте регистр накопления УчебныеОстатки, вид Остатки. Измерение Артикул (Строка 20), ресурс Количество (Число 15.3), реквизит Комментарий (Строка 100). Регистратор — УчебноеДвижение; включите регистр в движения документа.
В отдельной учебной конфигурации создайте общий реквизит УчебныйИсточник типа Строка 20. Разделение данных — Не использовать. В составе явно включите только учебный объект этого урока; использование — Использовать.
Если общий реквизит не выведен на форму, его пустое строковое значение допустимо. Запрос всё равно покажет именованную колонку УчебныйИсточник. Это не разделитель данных и не механизм ограничения доступа.
Общий реквизит УчебныйИсточник включите в состав именно регистра УчебныеОстатки. Виртуальные таблицы итогов этого урока его не используют: обычный неразделяющий реквизит там не является измерением.
В модуль объекта документа вставьте отдельный обработчик проведения ниже. Обновите только учебную базу.
Вручную проведите два учебных документа: 01.10.2026 12:00:00, Артикул КНИГА, Количество 10, Приход Истина, Комментарий Поступление; 02.10.2026 12:00:00, тот же артикул, Количество 3, Приход Ложь, Комментарий Продажа. Других движений КНИГА в этом учебном регистре не должно быть.
Основной код запроса запускайте в отдельной серверной процедуре учебной обработки, не внутри проведения. Запрос ничего не пишет и не перепроводит.
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Данные.Период, Данные.Регистратор, Данные.НомерСтроки,
| Данные.Активность, Данные.ВидДвижения, Данные.МоментВремени,
| Данные.Артикул, Данные.Количество, Данные.Комментарий,
| Данные.УчебныйИсточник
|ИЗ РегистрНакопления.УчебныеОстатки КАК Данные";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
Для Каждого Колонка Из Результат.Колонки Цикл
Сообщить(Колонка.Имя + ": " + Строка(Выборка[Колонка.Имя]));
КонецЦикла;
КонецЦикла;Проведение учебного движения
Документы → УчебноеДвижение → Модуль объекта
Выполняется только при ручном проведении подготовленных учебных документов.
Процедура ОбработкаПроведения(Отказ, РежимПроведения)
Движения.УчебныеОстатки.Записывать = Истина;
Запись = Движения.УчебныеОстатки.Добавить();
Запись.Период = Дата;
Запись.Активность = Истина;
Запись.Артикул = Артикул;
Запись.Количество = Количество;
Запись.Комментарий = Комментарий;
Запись.УчебныйИсточник = "Урок";
Если Приход Тогда
Запись.ВидДвижения = ВидДвиженияНакопления.Приход;
Иначе
Запись.ВидДвижения = ВидДвиженияНакопления.Расход;
КонецЕсли;
КонецПроцедурыРазбор по шагам
Проведение создало два движения по одному артикулу.
Количество расхода хранится как 3; направление Расход задаёт знак при расчёте итогов.
Регистратор и номер строки связывают каждое движение с его документом.
Как проверить результат
Две строки: Приход 10 и Расход 3, Активность Истина, НомерСтроки 1 у каждого документа.
Комментарий отличает Поступление от Продажа, УчебныйИсточник равен Урок.
Ожидаемый результат
Прочитаны исходные движения, а не итоговый остаток.
На что обратить внимание
Не записывайте отрицательное количество расхода одновременно с видом Расход: это меняет экономический смысл движения.
В выборке без сортировки порядок строк не гарантирован.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.