Class DateTimePicker

DateTimePicker

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

適用於 Google Workspace 外掛程式和 Google Chat 應用程式。

var 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設定欄位名稱,用來在有 UI 互動時產生的事件物件中識別這個挑選器。
setOnChangeAction(action)DateTimePicker設定當挑選器輸入內容變更時,指令碼會執行的 Action
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePicker設定時區應與世界標準時間偏移的分鐘數。
setTitle(title)DateTimePicker設定輸入欄位上方顯示的標題。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker設定要在輸入欄位設定的預填值。
setValueInMsSinceEpoch(valueMsEpoch)DateTimePicker設定要在輸入欄位設定的預填值。

內容詳盡的說明文件

setFieldName(fieldName)

設定欄位名稱,用來在有 UI 互動時產生的事件物件中識別這個挑選器。使用者會看到欄位名稱。必填;指定的欄位名稱不得重複。

參數

名稱類型說明
fieldNameString要指派給這項輸入內容的名稱。

回攻員

DateTimePicker — 用於鏈結的挑選器。


setOnChangeAction(action)

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

參數

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

回攻員

DateTimePicker — 用於鏈結的挑選器。


setTimeZoneOffsetInMins(timeZoneOffsetMins)

設定時區應與世界標準時間偏移的分鐘數。如果設定這個欄位,系統會使用指定時區顯示日期與時間。如果未設定,系統會以使用者的時區顯示時間。

參數

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

回攻員

DateTimePicker — 用於鏈結的挑選器。


setTitle(title)

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

參數

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

回攻員

DateTimePicker — 用於鏈結的挑選器。


setValueInMsSinceEpoch(valueMsEpoch)

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

參數

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

回攻員

DateTimePicker — 用於鏈結的挑選器。


setValueInMsSinceEpoch(valueMsEpoch)

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

參數

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

回攻員

DateTimePicker — 用於鏈結的挑選器。