Class TimePicker

TimePicker

ユーザーが時間を入力できる入力フィールド。

Google Workspace アドオンと Google Chat アプリで利用できます。

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

メソッド

メソッド戻り値の型概要
addEventAction(eventAction)Widgetウィジェットで実行できるイベント アクションを追加します。
setFieldName(fieldName)TimePickerUI 操作が行われたときに生成されるイベント オブジェクトで、このピッカーを識別するフィールド名を設定します。
setHours(hours)TimePicker入力フィールドに設定する事前入力された時間値を設定します。
setId(id)Widget変更するウィジェットの識別に使用される一意の ID を設定します。
setMinutes(minutes)TimePicker入力フィールドに設定する事前入力された分数を設定します。
setOnChangeAction(action)TimePickerピッカーの入力が変更されるたびにスクリプトが実行する Action を設定します。
setTitle(title)TimePicker入力フィールドの上に表示されるタイトルを設定します。
setVisibility(visibility)Widgetウィジェットの可視性を設定します。

詳細なドキュメント

addEventAction(eventAction)

ウィジェットで実行できるイベント アクションを追加します。

パラメータ

名前型説明
eventActionEventAction追加する EventAction。

戻る

Widget - チェーン用の Object。

setFieldName(fieldName)

UI 操作が発生したときに生成されるイベント オブジェクトで、このピッカーを識別するフィールド名を設定します。フィールド名はユーザーに表示されます。必須。指定されたフィールド名は一意である必要があります。

パラメータ

名前型説明
fieldNameStringこの入力に割り当てる名前。

戻る

TimePicker - チェーン用のこのピッカー。

setHours(hours)

入力フィールドに設定する事前入力された時間値を設定します。

パラメータ

名前型説明
hoursInteger入力に配置されるデフォルトの時間値。範囲は 0 ～ 23 です。フォーム コールバック パラメータでは常に文字列として表されます。

戻る

TimePicker - チェーン用のこのピッカー。

setId(id)

変更するウィジェットの識別に使用される一意の ID を設定します。ウィジェットの変更はアドオンでのみサポートされています。

パラメータ

名前型説明
idStringウィジェットの ID。64 文字以内で、`[a-zA-Z0-9-]+` の形式で指定します。

戻る

Widget - チェーン用のこのオブジェクト。

setMinutes(minutes)

入力フィールドに設定する事前入力された分数を設定します。

パラメータ

名前型説明
minutesInteger入力に配置されるデフォルトの分値。範囲は 0 ～ 59 です。フォーム コールバック パラメータでは常に文字列として表されます。

戻る

TimePicker - チェーン用のこのピッカー。

setOnChangeAction(action)

ピッカーの入力が変更されるたびにスクリプトが実行する Action を設定します。

パラメータ

名前型説明
actionAction実行する操作。

戻る

TimePicker - チェーン用のこのピッカー。

setTitle(title)

入力フィールドの上に表示されるタイトルを設定します。

パラメータ

名前型説明
titleString入力フィールドのタイトル。

戻る

TimePicker - チェーン用のこのピッカー。

setVisibility(visibility)

ウィジェットの可視性を設定します。デフォルト値は `VISIBLE` です。

パラメータ

名前型説明
visibilityVisibilityウィジェットの Visibility。

戻る

Widget - チェーン用の Object。