使用者可輸入時間的輸入欄位。
適用於 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'), );
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
add | Widget | 新增可在小工具上執行的事件動作。 |
set | Time | 設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。 |
set | Time | 設定要在輸入欄位中預先填入的小時數值。 |
set | Widget | 設定指派的專屬 ID，用於識別要變動的小工具。 |
set | Time | 設定要在輸入欄位中填入的預填分鐘值。 |
set | Time | 設定指令碼，在每次變更挑選器輸入內容時執行。Action |
set | Time | 設定顯示在輸入欄位上方的標題。 |
set | Widget | 設定小工具的顯示設定。 |
內容詳盡的說明文件
add
set
設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。使用者會看到欄位名稱。必填，指定的欄位名稱不得重複。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
field | String | 要指派給這個輸入內容的名稱。 |
回攻員
Time - 這個選擇器用於串連。
set
設定要在輸入欄位中預先填入的小時數值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
hours | Integer | 輸入欄位中的預設小時值，範圍為 0 到 23。在表單回呼參數中，一律以字串表示。 |
回攻員
Time - 這個選擇器用於串連。
set
設定指派的專屬 ID，用於識別要變動的小工具。外掛程式僅支援小工具突變。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
id | String | 小工具的 ID，最多 64 個字元，格式為 `[a-zA-Z0-9-]+`。 |
回攻員
Widget - 這個物件，用於鏈結。
set
設定要在輸入欄位中填入的預填分鐘值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
minutes | Integer | 輸入欄位中的預設分鐘值介於 0 到 59 之間。在表單回呼參數中，一律以字串表示。 |
回攻員
Time - 這個選擇器用於串連。