Class 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 Устанавливает видимость виджета.

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

add Event Action(eventAction)

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

Параметры

Имя Тип Описание
event Action Event Action Будет добавлено Event Action .

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

Widget — Объект, для объединения в цепочку.

set Field Name(fieldName)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Host App Data Source(hostAppDataSource)

В агенте Google Workspace Studio позволяет входным переменным принимать выходные данные типа datetime из других шагов агента. Например, получать время отправки сообщения 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 Источник данных.

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Id(id)

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

Параметры

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

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

Widget — объект для объединения в цепочку.

set On Change Action(action)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Time Zone Offset In Mins(timeZoneOffsetMins)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Title(title)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Value In Ms Since Epoch(valueMsEpoch)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Value In Ms Since Epoch(valueMsEpoch)

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

Параметры

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

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

Date Time Picker — этот выбор предназначен для объединения в цепочку.

set Visibility(visibility)

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

Параметры

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

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

Widget — Объект, для объединения в цепочку.