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 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 NameStringИмя, которое нужно присвоить этому входу.

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

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


set On Change Action(action)

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

Параметры

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

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

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


set Time Zone Offset In Mins(timeZoneOffsetMins)

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

Параметры

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

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

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


set Title(title)

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

Параметры

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

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

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


set Value In Ms Since Epoch(valueMsEpoch)

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

Параметры

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

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

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


set Value In Ms Since Epoch(valueMsEpoch)

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

Параметры

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

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

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