Глобальный контекст.ВвестиДатуАсинх

Методы · InputDateAsync

Асинхронная функция. Вызывает диалог для ввода даты, но при этом не ожидает завершения ввода.

Синтаксис

ВвестиДатуАсинх(<Дата>, <Подсказка>, <ЧастьДаты>)
Полное описание, параметры и ограничения

Глобальный контекст.ВвестиДатуАсинх (Global context.InputDateAsync)

Глобальный контекст (Global context)

ВвестиДатуАсинх (InputDateAsync)

Доступен, начиная с версии 8.3.18.

Синтаксис:
ВвестиДатуАсинх(<Дата>, <Подсказка>, <ЧастьДаты>)
Параметры:

<Дата> (обязательный)
Тип: Дата.
Имя доступной в модуле переменной. В эту переменную будет помещено введенное значение даты. Начальное значение переменной будет использовано в качестве начального значения в диалоге.

<Подсказка> (необязательный)
Тип: Строка.
Текст заголовка окна диалога ввода даты. Может использоваться в качестве подсказки пользователю.
Значение по умолчанию: Пустая строка.

<ЧастьДаты> (необязательный)
Тип: ЧастиДаты.
Вводимая в диалоге часть (или части) даты.
Значение по умолчанию: ДатаВремя.
Возвращаемое значение:
Тип: Обещание.
Результат выполнения обещания - выбранное значение даты или Неопределено, если пользователь отказался от ввода.
Описание:

Асинхронная функция. Вызывает диалог для ввода даты, но при этом не ожидает завершения ввода.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

См. также:
Глобальный контекст, метод ВвестиДату
Глобальный контекст, метод ПоказатьВводДаты

Использование в версии:

Доступен, начиная с версии 8.3.18.

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

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

Выбрать дату асинхронно и правильно обработать отмену

Начальная дата 15 сентября 2026 года. Результат обещания — выбранная дата или Неопределено при отмене; сохраняем значение только после проверки.

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

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

Подготовка

  1. Создайте отдельную учебную внешнюю обработку с пустой управляемой основной формой. Каждую задачу запускайте в своей копии формы.

  2. Не добавляйте вручную реквизит ЗначениеПримера, поле ПолеПримера и команду УчебноеДействие: их создаст код.

  3. В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Вставьте весь модуль, включая клиентские и серверные процедуры.

  4. Сохраните учебную EPF и откройте через Файл → Открыть в тонком или толстом клиенте Windows. Рабочие данные не читаются и не записываются.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Дата", , , Новый КвалификаторыДаты(ЧастиДаты.Дата));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = Дата(2026, 9, 15);
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Учебная дата";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выбрать учебную дату";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Асинх Процедура УчебноеДействие(Команда)
    НачальнаяДата = ЗначениеПримера;
    ВыбраннаяДата = Ждать ВвестиДатуАсинх(НачальнаяДата, "Дата только для учебной формы", ЧастиДаты.Дата);
    Если ВыбраннаяДата = Неопределено Тогда
        Сообщить("Выбор отменён, дата формы сохранена");
        Возврат;
    КонецЕсли;
    ЗначениеПримера = НачалоДня(ВыбраннаяДата);
    Сообщить("Выбрана дата: " + Формат(ЗначениеПримера, "ДФ=dd.MM.yyyy"));
КонецПроцедуры

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

  1. Реквизит формы имеет тип Дата с квалификатором только даты, без времени.

  2. Локальная НачальнаяДата даёт диалогу исходное значение; фактический результат читаем из Ждать.

  3. ВвестиДатуАсинх возвращает обещание с датой, не логический признак успеха.

  4. При Неопределено не изменяем реквизит и завершаем обработчик.

  5. При выборе присваиваем дату начала дня. Формат задаёт только человекочитаемый вывод сообщения.

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

  1. Отмените диалог: дата в поле остаётся 15.09.2026.

  2. Выберите 20.09.2026: реквизит и сообщение содержат новую дату без времени.

  3. Дата не записывается в документ и не становится рабочей датой сеанса.

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

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

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

  1. Не сравнивайте результат с Истина/Ложь: обещание возвращает дату либо Неопределено.

  2. Текстовый формат даты не должен использоваться вместо типизированной даты в расчётах.

  3. Выбранная дата не задаёт часовой пояс и не преобразует дату сервиса из UTC.

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

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

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

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

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