可輸入日期的輸入欄位。
適用於 Google Workspace 外掛程式和 Google Chat 應用程式。
const dateTimePicker = CardService.newDatePicker() .setTitle('Enter the date.') .setFieldName('date_field') // Set default value as Jan 1, 2018 UTC. Either a number or string is // acceptable. .setValueInMsSinceEpoch(1514775600) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
add | Widget | 新增可在小工具上執行的事件動作。 |
set | Date | 設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。 |
set | Widget | 設定指派的專屬 ID，用於識別要變動的小工具。 |
set | Date | 設定指令碼，在每次變更挑選器輸入內容時執行。Action |
set | Date | 設定顯示在輸入欄位上方的標題。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
set | Widget | 設定小工具的顯示設定。 |
內容詳盡的說明文件
add
set
設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。使用者會看到欄位名稱。必填，指定的欄位名稱不得重複。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
field | String | 要指派給這個輸入內容的名稱。 |
回攻員
Date - This picker, for chaining.
set
設定指派的專屬 ID，用於識別要變動的小工具。外掛程式僅支援小工具突變。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
id | String | 小工具的 ID，最多 64 個字元，格式為 `[a-zA-Z0-9-]+`。 |
回攻員
Widget - 這個物件，用於鏈結。
set
設定指令碼，在每次變更挑選器輸入內容時執行。Action
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
action | Action | 要採取的動作。 |
回攻員
Date - This picker, for chaining.
set
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | Number | 輸入欄位中的預設值，以自 Epoch 紀元時間起算的毫秒數表示。系統只會使用紀元時間的日期，並捨棄紀元時間。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - 這個選擇器用於串連。
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | String | 輸入內容中預設值 (以字串形式表示，自 Epoch 紀元時間起算的毫秒數)。系統只會使用紀元時間的日期，並捨棄紀元時間。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - This picker, for chaining.