Class DateTimePicker

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

メソッド

メソッド戻り値の型概要
addEventAction(eventAction)Widgetウィジェットで実行できるイベント アクションを追加します。
setFieldName(fieldName)DateTimePickerUI 操作が行われたときに生成されるイベント オブジェクトで、このピッカーを識別するフィールド名を設定します。
setHostAppDataSource(hostAppDataSource)DateTimePickerGoogle Workspace Studio エージェントで、入力変数がエージェントの他のステップから日時出力を受け入れるようになりました。
setId(id)Widget変更するウィジェットの識別に使用される一意の ID を設定します。
setOnChangeAction(action)DateTimePickerピッカーの入力が変更されるたびにスクリプトが実行する Action を設定します。
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerタイムゾーンを UTC からオフセットする分数値を設定します。
setTitle(title)DateTimePicker入力フィールドの上に表示されるタイトルを設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定する事前入力値を設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定する事前入力値を設定します。
setVisibility(visibility)Widgetウィジェットの可視性を設定します。

詳細なドキュメント

addEventAction(eventAction)

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

パラメータ

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

戻る

Widget - チェーン用の Object。

setFieldName(fieldName)

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

パラメータ

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

戻る

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

setHostAppDataSource(hostAppDataSource)

Google Workspace Studio エージェントでは、入力変数でエージェントの他のステップから日時出力を受け取ることができます。たとえば、Gmail メッセージが送信された時刻や、カレンダーの予定がスケジュールされた日付を取得します。

Google Workspace Studio を拡張する Google Workspace アドオンでのみ使用できます。

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

パラメータ

名前型説明
hostAppDataSourceHostAppDataSourceデータソース。

戻る

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

setId(id)

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

パラメータ

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

戻る

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

setOnChangeAction(action)

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

パラメータ

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

戻る

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

setTimeZoneOffsetInMins(timeZoneOffsetMins)

タイムゾーンを UTC からオフセットする分数値を設定します。設定されている場合、日付と時刻は指定されたタイムゾーンで表示されます。設定されていない場合、時間はユーザーのタイムゾーンで表示されます。

パラメータ

名前型説明
timeZoneOffsetMinsIntegerタイムゾーンが UTC からオフセットされている分数。

戻る

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

setTitle(title)

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

パラメータ

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

戻る

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

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

名前型説明
valueMsEpochNumberエポックからのミリ秒単位の数値として入力に配置されるデフォルト値。フォーム コールバック パラメータでは常に文字列として表されます。

戻る

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

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

名前型説明
valueMsEpochStringエポックからのミリ秒単位で、文字列として入力に配置されるデフォルト値。フォーム コールバック パラメータでは常に文字列として表されます。

戻る

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

setVisibility(visibility)

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

パラメータ

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

戻る

Widget - チェーン用の Object。