Class 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 操作が発生したときに生成されるイベント オブジェクトで、この選択ツールを識別するフィールド名を設定します。
setOnChangeAction(action)DateTimePicker選択ツールの入力が変更されるたびにスクリプトが実行する Action を設定します。
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerタイムゾーンと UTC との時差を分単位で設定します。
setTitle(title)DateTimePicker入力フィールドの上に表示されるタイトルを設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定するプリフィル値を設定します。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker入力フィールドに設定するプリフィル値を設定します。

詳細なドキュメント

setFieldName(fieldName)

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

パラメータ

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

戻る

DateTimePicker - チェーン用のこの選択ツール。

setOnChangeAction(action)

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

パラメータ

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

戻る

DateTimePicker - チェーン用のこの選択ツール。

setTimeZoneOffsetInMins(timeZoneOffsetMins)

タイムゾーンと UTC との時差を分単位で設定します。設定すると、日時が指定されたタイムゾーンで表示されます。設定しない場合、時刻はユーザーのタイムゾーンで表示されます。

パラメータ

名前型説明
timeZoneOffsetMinsIntegerタイムゾーンが UTC からずれている分数。

戻る

DateTimePicker - チェーン用のこの選択ツール。

setTitle(title)

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

パラメータ

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

戻る

DateTimePicker - チェーン用のこの選択ツール。

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

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

戻る

DateTimePicker - チェーン用のこの選択ツール。

setValueInMsSinceEpoch(valueMsEpoch)

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

パラメータ

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

戻る

DateTimePicker - チェーン用のこの選択ツール。