Class DateTimePicker

DateTimePicker

Поле ввода, позволяющее пользователям вводить дату и время.

Поддерживается проверка данных при отправке формы. Если Action.setAllWidgetsAreRequired(allWidgetsAreRequired) установлено в true или этот виджет указан через Action.addRequiredWidget(requiredWidget) , отправка формы блокируется, если не выбрано значение.

Доступно для дополнений Google Workspace и приложений Google Chat.

const dateTimePicker =
    CardService.newDateTimePicker()
        .setTitle('Enter the date and time.')
        .setFieldName('date_time_field')
        // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or
        // string is acceptable.
        .setValueInMsSinceEpoch(1514775600)
        // EDT time is 5 hours behind UTC.
        .setTimeZoneOffsetInMins(-5 * 60)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Методы

Метод Тип возвращаемого значения Краткое описание
add Event Action(eventAction) Widget Добавляет действие события, которое можно выполнить с виджетом.
set Field Name(fieldName) Date Time Picker Задает имя поля, идентифицирующего этот элемент выбора в объекте события, генерируемом при взаимодействии с пользовательским интерфейсом.
set Host App Data Source(hostAppDataSource) Date Time Picker В агенте Google Workspace Studio входные переменные могут принимать значения даты и времени из других шагов агента.
set Id(id) Widget Задает уникальный идентификатор, используемый для идентификации виджета, подлежащего изменению.
set On Change Action(action) Date Time Picker Задает Action , которое скрипт будет выполнять при изменении значения в поле выбора.
set Time Zone Offset In Mins(timeZoneOffsetMins) Date Time Picker Задает количество минут, на которое часовой пояс должен быть смещен относительно UTC.
set Title(title) Date Time Picker Задает заголовок, отображаемый над полем ввода.
set Value In Ms Since Epoch(valueMsEpoch) Date Time Picker Задает предварительно заполненное значение, которое будет введено в поле ввода.
set Value In Ms Since Epoch(valueMsEpoch) Date Time Picker Задает предварительно заполненное значение, которое будет введено в поле ввода.
set Visibility(visibility) Widget Задает видимость виджета.

Подробная документация

addEventAction(eventAction)

Добавляет действие события, которое можно выполнить с виджетом.

Параметры

Имя Тип Описание
event Action Event Action Необходимо добавить Event Action .

Возвращаться

Widget — Объект для создания цепочек.

setFieldName(fieldName)

Задает имя поля, идентифицирующего этот элемент выбора в объекте события, генерируемом при взаимодействии с пользовательским интерфейсом. Имя поля видно пользователю. Обязательный параметр; указанное имя поля должно быть уникальным.

Параметры

Имя Тип Описание
field Name String Имя, которое следует присвоить этому полю ввода.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setHostAppDataSource(hostAppDataSource)

В агенте Google Workspace Studio входные переменные могут принимать выходные данные в формате дата и время от других шагов агента. Например, время отправки сообщения Gmail или дата, на которую запланировано событие в календаре.

Доступно только для дополнений Google Workspace, расширяющих функциональность Google Workspace Studio.

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Параметры

Имя Тип Описание
host App Data Source Host App Data Source Источник данных.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setId(id)

Задает уникальный идентификатор, используемый для идентификации виджета, который необходимо изменить. Изменение виджетов поддерживается только в дополнениях.

Параметры

Имя Тип Описание
id String Идентификатор виджета, ограниченный 64 символами и в формате `[a-zA-Z0-9-]+`.

Возвращаться

Widget — этот объект используется для создания цепочек вызовов.

setOnChangeAction(action)

Задает Action , которое скрипт будет выполнять при изменении значения в поле выбора.

Параметры

Имя Тип Описание
action Action Действие, которое необходимо предпринять.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

Параметры

Имя Тип Описание
time Zone Offset Mins Integer Количество минут, на которое часовой пояс смещен относительно UTC.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setTitle(title)

Задает заголовок, отображаемый над полем ввода.

Параметры

Имя Тип Описание
title String Заголовок поля ввода.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setValueInMsSinceEpoch(valueMsEpoch)

Задает предварительно заполненное значение, которое будет введено в поле ввода.

Параметры

Имя Тип Описание
value Ms Epoch Number Значение по умолчанию, заданное во входных данных в виде числа, выраженного в миллисекундах с начала эпохи. В параметрах обратного вызова оно всегда представляется в виде строки.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setValueInMsSinceEpoch(valueMsEpoch)

Задает предварительно заполненное значение, которое будет введено в поле ввода.

Параметры

Имя Тип Описание
value Ms Epoch String Значение по умолчанию, заданное во входных данных в виде строки, в миллисекундах с начала эпохи. В параметрах обратного вызова формы оно всегда представляется в виде строки.

Возвращаться

DateTimePicker — Этот инструмент предназначен для создания цепочек дат и времени.

setVisibility(visibility)

Задает видимость виджета. Значение по умолчанию — `VISIBLE`.

Параметры

Имя Тип Описание
visibility Visibility Visibility виджета.

Возвращаться

Widget — Объект для создания цепочек.