Период

Язык запросов · Period

Синтаксис и применение Период в платформе 1С:Предприятие. Описание и примеры кода.

Полное описание, параметры и ограничения

Период (Period)

Период (Period)
Тип: Дата.
Содержит период, к которому относится запись регистра.

Методическая информация

Практические примеры

Увидеть приход и расход до свёртки в итоги

Основная таблица показывает каждую активную запись с направлением и положительным количеством.

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. В отдельной учебной конфигурации создайте документ УчебноеДвижение с разрешённым проведением и автонумерацией. Реквизиты: Артикул (Строка 20), Количество (Число 15.3), Приход (Булево), Комментарий (Строка 100).

  2. Создайте регистр накопления УчебныеОстатки, вид Остатки. Измерение Артикул (Строка 20), ресурс Количество (Число 15.3), реквизит Комментарий (Строка 100). Регистратор — УчебноеДвижение; включите регистр в движения документа.

  3. В отдельной учебной конфигурации создайте общий реквизит УчебныйИсточник типа Строка 20. Разделение данных — Не использовать. В составе явно включите только учебный объект этого урока; использование — Использовать.

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

  5. Общий реквизит УчебныйИсточник включите в состав именно регистра УчебныеОстатки. Виртуальные таблицы итогов этого урока его не используют: обычный неразделяющий реквизит там не является измерением.

  6. В модуль объекта документа вставьте отдельный обработчик проведения ниже. Обновите только учебную базу.

  7. Вручную проведите два учебных документа: 01.10.2026 12:00:00, Артикул КНИГА, Количество 10, Приход Истина, Комментарий Поступление; 02.10.2026 12:00:00, тот же артикул, Количество 3, Приход Ложь, Комментарий Продажа. Других движений КНИГА в этом учебном регистре не должно быть.

  8. Основной код запроса запускайте в отдельной серверной процедуре учебной обработки, не внутри проведения. Запрос ничего не пишет и не перепроводит.

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
| Данные.Период, Данные.Регистратор, Данные.НомерСтроки,
| Данные.Активность, Данные.ВидДвижения, Данные.МоментВремени,
| Данные.Артикул, Данные.Количество, Данные.Комментарий,
| Данные.УчебныйИсточник
|ИЗ РегистрНакопления.УчебныеОстатки КАК Данные";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
    Для Каждого Колонка Из Результат.Колонки Цикл
        Сообщить(Колонка.Имя + ": " + Строка(Выборка[Колонка.Имя]));
    КонецЦикла;
КонецЦикла;
Проведение учебного движения

Документы → УчебноеДвижение → Модуль объекта

Выполняется только при ручном проведении подготовленных учебных документов.

Процедура ОбработкаПроведения(Отказ, РежимПроведения)
    Движения.УчебныеОстатки.Записывать = Истина;
    Запись = Движения.УчебныеОстатки.Добавить();
    Запись.Период = Дата;
    Запись.Активность = Истина;
    Запись.Артикул = Артикул;
    Запись.Количество = Количество;
    Запись.Комментарий = Комментарий;
    Запись.УчебныйИсточник = "Урок";
    Если Приход Тогда
        Запись.ВидДвижения = ВидДвиженияНакопления.Приход;
    Иначе
        Запись.ВидДвижения = ВидДвиженияНакопления.Расход;
    КонецЕсли;
КонецПроцедуры

Разбор по шагам

  1. Проведение создало два движения по одному артикулу.

  2. Количество расхода хранится как 3; направление Расход задаёт знак при расчёте итогов.

  3. Регистратор и номер строки связывают каждое движение с его документом.

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

  1. Две строки: Приход 10 и Расход 3, Активность Истина, НомерСтроки 1 у каждого документа.

  2. Комментарий отличает Поступление от Продажа, УчебныйИсточник равен Урок.

Ожидаемый результат

Прочитаны исходные движения, а не итоговый остаток.

На что обратить внимание

  1. Не записывайте отрицательное количество расхода одновременно с видом Расход: это меняет экономический смысл движения.

  2. В выборке без сортировки порядок строк не гарантирован.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.