Class DateTimePicker

日期時間挑選器

可讓使用者輸入日期和時間的輸入欄位。

適用於 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)DateTimePicker設定在使用者介面互動時產生的事件物件中,用於識別此選擇器的欄位名稱。
setOnChangeAction(action)DateTimePicker設定 Action,當挑選器輸入內容變更時,指令碼就會執行。
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePicker設定時區與世界標準時間 (UTC) 的偏差分鐘數。
setTitle(title)DateTimePicker設定輸入欄位上方顯示的標題。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker設定要設在輸入欄位的預先填入值。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker設定要設在輸入欄位的預先填入值。

內容詳盡的說明文件

setFieldName(fieldName)

設定欄位名稱,用於在使用者介面互動時產生的事件物件中,識別此選擇器。使用者可看見欄位名稱。必填欄位名稱不得重複。

參數

名稱類型說明
fieldNameString要指派給此輸入來源的名稱。

回攻員

DateTimePicker:這個選擇器,用於鏈結。


setOnChangeAction(action)

設定 Action,當挑選器輸入內容變更時,指令碼就會執行。

參數

名稱類型說明
actionAction要採取的動作。

回攻員

DateTimePicker:這個選擇器,用於鏈結。


setTimeZoneOffsetInMins(timeZoneOffsetMins)

設定時區與世界標準時間 (UTC) 的偏差分鐘數。如果已設定,日期和時間就會以指定時區顯示。如果未設定,系統會以使用者所在時區顯示時間。

參數

名稱類型說明
timeZoneOffsetMinsInteger時區與世界標準時間的偏差分鐘數。

回攻員

DateTimePicker:這個選擇器,用於鏈結。


setTitle(title)

設定輸入欄位上方顯示的標題。

參數

名稱類型說明
titleString輸入欄位標題。

回攻員

DateTimePicker:這個選擇器,用於鏈結。


setValueInMsSinceEpoch(valueMsEpoch)

設定要設在輸入欄位的預先填入值。

參數

名稱類型說明
valueMsEpochNumber輸入內容中的預設值為數字,以 Epoch 紀元時間起算的毫秒數為單位。在表單回呼參數中,這項屬性一律會以字串表示。

回攻員

DateTimePicker:這個選擇器,用於鏈結。


setValueInMsSinceEpoch(valueMsEpoch)

設定要設在輸入欄位的預先填入值。

參數

名稱類型說明
valueMsEpochString這個預設值會以字串形式放入輸入內容,以 Epoch 紀元時間起算的毫秒數為單位。在表單回呼參數中,這項屬性一律會以字串表示。

回攻員

DateTimePicker:這個選擇器,用於鏈結。