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'),
        );

Методы

Метод Тип возврата Краткое описание
set Field Name(fieldName) Date Time Picker Задает имя поля, идентифицирующего данный выборщик в объекте события, который генерируется при взаимодействии с пользовательским интерфейсом.
set Host App Data Source(hostAppDataSource) Date Time Picker В потоке Google Workspace позволяет входным переменным принимать выходные данные даты и времени из других шагов потока.
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 Field Name(fieldName)

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

Параметры

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

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

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

set Host App Data Source(hostAppDataSource)

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

Доступно только в рамках программы Gemini Alpha для дополнений Google Workspace, расширяющих Google Workspace Flows.

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 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 — этот выбор предназначен для объединения в цепочку.