Получает дату начала периода.
Синтаксис
ПолучитьДатуНачала()Примеры платформы
НастройкаПериода = Новый НастройкаПериода;
НастройкаПериода.УстановитьПериод(ДатаНачалаПериода, ДатаОкончанияПериода);
Если НастройкаПериода.Редактировать() Тогда
ДатаНачалаПериода = НастройкаПериода.ПолучитьДатуНачала();
ДатаОкончанияПериода = НастройкаПериода.ПолучитьДатуОкончания();
КонецЕсли;Полное описание, параметры и ограничения
НастройкаПериода.ПолучитьДатуНачала (PeriodSettings.GetDateFrom)
НастройкаПериода (PeriodSettings)
ПолучитьДатуНачала (GetDateFrom)
Доступен, начиная с версии 8.0.
Синтаксис:
ПолучитьДатуНачала()
Возвращаемое значение:
Тип: Дата.
Описание:
Получает дату начала периода.
Доступность:
Толстый клиент.
Примечание:
Если граница интервала задана как БезОграничения, то будет возвращена пустая дата.
Пример:
НастройкаПериода = Новый НастройкаПериода;
НастройкаПериода.УстановитьПериод(ДатаНачалаПериода, ДатаОкончанияПериода);
Если НастройкаПериода.Редактировать() Тогда
ДатаНачалаПериода = НастройкаПериода.ПолучитьДатуНачала();
ДатаОкончанияПериода = НастройкаПериода.ПолучитьДатуОкончания();
КонецЕсли;
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Применить выбор периода только после ОК
Открываем собственный диалог с двумя вкладками; отмена не переписывает используемые учебные границы.
Где и как запускать
Полный модуль управляемой формы собственной обработки, толстый клиент с разрешёнными модальными вызовами.
Подготовка
Собственная учебная база 8.5.1.1343, толстый клиент Windows. Создайте внешнюю обработку с управляемой формой, командой Выполнить и её кнопкой; вставьте весь модуль выбранного урока в форму.
НастройкаПериода доступна толстому клиенту, не тонкому/веб-клиенту и не серверу. Урок не подключается к спискам документов и не меняет их отбор.
Для урока с Редактировать нужен режим конфигурации, допускающий модальные вызовы. Не включайте его в рабочей конфигурации ради примера: выберите собственный учебный стенд с подходящим режимом.
Фиксированные даты относятся к сентябрю 2026 года. В уроке со смещениями рабочая дата только читается, не изменяется.
&НаКлиенте
Процедура Выполнить(Команда)
ПримененноеНачало = Дата(2026, 9, 1);
ПримененноеОкончание = Дата(2026, 9, 30, 23, 59, 59);
Период = Новый НастройкаПериода;
Период.УстановитьПериод(ПримененноеНачало, ПримененноеОкончание, Ложь);
Период.РедактироватьКакИнтервал = Истина;
Период.РедактироватьКакПериод = Истина;
Период.ВариантНастройки = ВариантНастройкиПериода.Интервал;
Сообщить(Период.РедактироватьКакИнтервал И Период.РедактироватьКакПериод);
Подтвержден = Период.Редактировать();
Если Подтвержден Тогда
ПримененноеНачало = Период.ПолучитьДатуНачала();
ПримененноеОкончание = Период.ПолучитьДатуОкончания();
Сообщить("ОК: применены учебные границы выбранного периода");
Иначе
Сообщить(ПримененноеНачало = Дата(2026, 9, 1));
Сообщить(ПримененноеОкончание = Дата(2026, 9, 30, 23, 59, 59));
Сообщить("Отмена: учебные границы не изменены");
КонецЕсли;
Сообщить(СтрШаблон("Начало=%1; окончание=%2", ПримененноеНачало, ПримененноеОкончание));
КонецПроцедурыРазбор по шагам
РедактироватьКакИнтервал/РедактироватьКакПериод управляют видимостью вкладок. При двух доступных вкладках ВариантНастройки выбирает первоначально активную.
Редактировать возвращает Булево: Истина только при ОК. Закрытие/отмена идут в ветку Иначе.
Храним применённые границы отдельно от редактируемого объекта. Чтение новых границ происходит лишь после подтверждения.
Мы не утверждаем, что сам объект диалога откатывает все внутренние изменения при отмене: пример защищает именно свои применённые значения.
Как проверить результат
Первый запуск: поменяйте даты и нажмите Отмена. Две проверки неизменности дают Истина; итог остаётся сентябрём.
Второй запуск: выберите 10–20 сентября и ОК. В итоговом сообщении должны быть подтверждённые границы.
Никакие документы, настройки пользователя или отборы существующих списков не изменены.
Ожидаемый результат
Получен реальный сценарий диалога с явным разделением редактирования, подтверждения и применения.
На что обратить внимание
Модальный вызов нельзя использовать в тонком клиенте или при запрещённых модальных вызовах.
Не читать и не применять getter после отмены без проверки результата Редактировать.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отделить конкретные границы периода от отсутствия ограничения
На собственном интервале просмотра проверяем установку дат, вычисленные границы и пустую дату для неограниченного начала.
Где и как запускать
Полный модуль управляемой формы собственной обработки, только толстый клиент.
Подготовка
Собственная учебная база 8.5.1.1343, толстый клиент Windows. Создайте внешнюю обработку с управляемой формой, командой Выполнить и её кнопкой; вставьте весь модуль выбранного урока в форму.
НастройкаПериода доступна толстому клиенту, не тонкому/веб-клиенту и не серверу. Урок не подключается к спискам документов и не меняет их отбор.
Для урока с Редактировать нужен режим конфигурации, допускающий модальные вызовы. Не включайте его в рабочей конфигурации ради примера: выберите собственный учебный стенд с подходящим режимом.
Фиксированные даты относятся к сентябрю 2026 года. В уроке со смещениями рабочая дата только читается, не изменяется.
&НаКлиенте
Процедура Выполнить(Команда)
Период = Новый НастройкаПериода;
Начало = Дата(2026, 9, 10, 0, 0, 0);
Окончание = Дата(2026, 9, 20, 23, 59, 59);
Период.УстановитьПериод(Начало, Окончание, Ложь);
Период.ВариантНастройки = ВариантНастройкиПериода.Интервал;
Период.ВариантНачала = ВариантГраницыИнтервала.КонкретнаяДата;
Период.ВариантОкончания = ВариантГраницыИнтервала.КонкретнаяДата;
Период.ДатаНачала = Начало;
Период.ДатаОкончания = Окончание;
Сообщить(Период.ПолучитьДатуНачала() = Начало);
Сообщить(Период.ПолучитьДатуОкончания() = Окончание);
Сообщить(Период.ДатаНачала = Начало);
Сообщить(Период.ДатаОкончания = Окончание);
Период.ВариантНачала = ВариантГраницыИнтервала.БезОграничения;
Сообщить(Период.ПолучитьДатуНачала() = Дата(1, 1, 1));
Сообщить(Период.ПолучитьДатуОкончания() = Окончание);
КонецПроцедурыРазбор по шагам
УстановитьПериод может автоматически подобрать вариант периода. После вызова явно задаём режим интервала и конкретные варианты обеих границ.
ДатаНачала/ДатаОкончания — значения настроек, а ПолучитьДатуНачала/ПолучитьДатуОкончания — вычисленные границы с учётом выбранного варианта.
БезОграничения переключает смысл начала. Getter возвращает пустую дату 01.01.0001, а не Неопределено и не текущую дату.
Окончание 20 сентября включает последнюю секунду дня. Этот интервал не выдаётся за полуоткрытый интервал запроса.
Как проверить результат
Шесть сообщений ожидаются Истина. Отсутствие ограничения проверяется через getter, не через старое поле ДатаНачала.
Внешний список документов не открыт и не отфильтрован: изменён только собственный объект в памяти.
Ожидаемый результат
Получен воспроизводимый пример конкретного интервала и независимого снятия ограничения начала.
На что обратить внимание
Не превращать пустую дату неограниченной границы в реальный отбор >= 01.01.0001 без бизнес-правила.
Этот тип нельзя переносить на сервер лишь потому, что даты доступны серверу.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.