Class TimePicker

時間挑選器

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

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

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

方法

方法傳回類型簡短說明
setFieldName(fieldName)TimePicker設定在使用者介面互動時產生的事件物件中,用於識別此選擇器的欄位名稱。
setHours(hours)TimePicker設定要設定在輸入欄位的預先填入小時數值。
setMinutes(minutes)TimePicker設定在輸入欄位中預先填入的分鐘數值。
setOnChangeAction(action)TimePicker設定 Action,當挑選器輸入內容變更時,指令碼就會執行。
setTitle(title)TimePicker設定輸入欄位上方顯示的標題。

內容詳盡的說明文件

setFieldName(fieldName)

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

參數

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

回攻員

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


setHours(hours)

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

參數

名稱類型說明
hoursInteger輸入的預設小時值,範圍為 0 到 23。在表單回呼參數中,一律會以字串表示。

回攻員

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


setMinutes(minutes)

設定在輸入欄位中預先填入的分鐘數值。

參數

名稱類型說明
minutesInteger輸入格中的預設分鐘值範圍為 0 到 59。在表單回呼參數中,一律會以字串表示。

回攻員

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


setOnChangeAction(action)

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

參數

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

回攻員

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


setTitle(title)

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

參數

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

回攻員

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