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

Другое · 5 мин

Как получить период из регистра сведений в 1С

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

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

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

Результат зависит от режима среза: СрезПоследних, СрезПоследнихЗаПериод, СрезПервых и другие варианты возвращают разные наборы записей. Одинаковый отбор по дате в разных режимах может дать разные периоды.

Что считать периодом в регистре сведений

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

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

Получение периода через запрос

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

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

1c
ВЫБРАТЬ РАЗЛИЧНЫЕ Период ИЗ РегистрСведений.ИмяРегистра КАЧЕСТВО? ГДЕ Период между Параметр1 и Параметр2

Отбор по периоду и границы интервала

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

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

Порядок действий при получении периода

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

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

Порядок действий
  1. 1
    Уточните имя измерения периода и тип регистра
  2. 2
    Выберите режим среза виртуальной таблицы
  3. 3
    Составьте запрос с отбором по началу и концу периода
  4. 4
    Проверьте возвращаемые даты и границы интервала

Проверка результата и типичные ошибки

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

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

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

Ограничения и безопасная работа

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

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

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

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

Есть ли записи в регистре за выбранный период
Норма

Запрос возвращает ожидаемые даты

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

Пустой результат или даты вне интервала

Соответствует ли режим среза задаче
Норма

Возвращены нужные записи за период

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

Возвращены только последние или первые записи

Альтернативы и сложные случаи

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

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

Итог

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

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

Нужно ли всегда использовать виртуальную таблицу?

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

Что делать, если запрос вернул пустой результат?

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

Может ли период отличаться от даты документа?

Да. Дата документа и период записи в регистре сведений — разные значения. Период определяется настройками регистра и может не совпадать с моментом проведения документа.

Безопасно ли менять имя измерения периода?

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