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)	TimePicker	UI 操作が発生したときに生成されるイベント オブジェクトで、このピッカーを識別するフィールド名を設定します。
setHours(hours)	TimePicker	入力フィールドに設定する事前入力済みの時間値を設定します。
setId(id)	Widget	変更するウィジェットの識別に使用される一意の ID を設定します。
setMinutes(minutes)	TimePicker	入力フィールドに設定する事前入力済みの分値を設定します。
setOnChangeAction(action)	TimePicker	ピッカーの入力が変更されるたびにスクリプトが実行する Action を設定します。
setTitle(title)	TimePicker	入力フィールドの上に表示されるタイトルを設定します。
setVisibility(visibility)	Widget	ウィジェットの表示 / 非表示を設定します。

詳細なドキュメント

addEventAction(eventAction)

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

パラメータ

名前	タイプ	説明
eventAction	EventAction	追加する EventAction。

戻る

Widget - チェーン用の Object。

---

setFieldName(fieldName)

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

パラメータ

名前	タイプ	説明
fieldName	String	この入力に割り当てる名前。

戻る

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

---

setHours(hours)

入力フィールドに設定する事前入力済みの時間値を設定します。

パラメータ

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

戻る

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

---

setId(id)

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

パラメータ

名前	タイプ	説明
id	String	ウィジェットの ID。64 文字以内で、形式は `[a-zA-Z0-9-]+` です。

戻る

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

---

setMinutes(minutes)

入力フィールドに設定する事前入力済みの分値を設定します。

パラメータ

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

戻る

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

---

setOnChangeAction(action)

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

パラメータ

名前	タイプ	説明
action	Action	実行する操作。

戻る

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

---

setTitle(title)

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

パラメータ

名前	タイプ	説明
title	String	入力フィールドのタイトル。

戻る

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

---

setVisibility(visibility)

ウィジェットの表示 / 非表示を設定します。デフォルト値は `VISIBLE` です。

パラメータ

名前	タイプ	説明
visibility	Visibility	ウィジェットの Visibility。

戻る

Widget - チェーン用の Object。