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

メソッド

メソッド戻り値の型概要
setFieldName(fieldName)DateTimePickerUI 操作が発生したときに生成されるイベント オブジェクトで、このピッカーを識別するフィールド名を設定します。
setHostAppDataSource(hostAppDataSource)DateTimePickerGoogle Workspace フローでは、入力変数がフローの他のステップからの日時出力を受け入れます。
setOnChangeAction(action)DateTimePickerピッカーの入力が変更されるたびにスクリプトが実行する Action を設定します。
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerタイムゾーンを UTC からオフセットする分数値を設定します。
setTitle(title)DateTimePicker入力フィールドの上に表示されるタイトルを設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定する事前入力値を設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定する事前入力値を設定します。

詳細なドキュメント

setFieldName(fieldName)

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

パラメータ

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

戻る

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

setHostAppDataSource(hostAppDataSource)

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

Google Workspace フローを拡張する Google Workspace アドオンの Gemini アルファ プログラムでのみ利用できます。

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 - チェーン用のこのピッカー。

setOnChangeAction(action)

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

パラメータ

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

戻る

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

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

パラメータ

名前型説明
timeZoneOffsetMinsIntegerタイムゾーンの UTC からのオフセット（分単位）。

戻る

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

setTitle(title)

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

パラメータ

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

戻る

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

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

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

戻る

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

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

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

戻る

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