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設定在 UI 互動時產生的事件物件中，用於識別此選擇器的欄位名稱。
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：這個選擇器可用於鏈結。