Class DatePicker

Выбор даты

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

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

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Методы

Метод Тип возвращаемого значения Краткое описание
add Event Action(eventAction) Widget Добавляет действие события, которое можно выполнить с виджетом.
set Field Name(fieldName) Date Picker Задает имя поля, идентифицирующего этот элемент выбора в объекте события, генерируемом при взаимодействии с пользовательским интерфейсом.
set Id(id) Widget Задает уникальный идентификатор, используемый для идентификации виджета, подлежащего изменению.
set On Change Action(action) Date Picker Задает Action , которое скрипт будет выполнять при изменении значения в поле выбора.
set Title(title) Date Picker Задает заголовок, отображаемый над полем ввода.
set Value In Ms Since Epoch(valueMsEpoch) Date Picker Задает предварительно заполненное значение, которое будет введено в поле ввода.
set Value In Ms Since Epoch(valueMsEpoch) Date Picker Задает предварительно заполненное значение, которое будет введено в поле ввода.
set Visibility(visibility) Widget Задает видимость виджета.

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

addEventAction(eventAction)

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

Параметры

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

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

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

setFieldName(fieldName)

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

Параметры

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

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

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

setId(id)

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

Параметры

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

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

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

setOnChangeAction(action)

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

Параметры

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

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

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

setTitle(title)

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

Параметры

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

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

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

setValueInMsSinceEpoch(valueMsEpoch)

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

Параметры

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

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

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

setValueInMsSinceEpoch(valueMsEpoch)

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

Параметры

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

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

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

setVisibility(visibility)

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

Параметры

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

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

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