使用者可輸入日期和時間的輸入欄位。
支援表單提交驗證。如果 Action.setAllWidgetsAreRequired(allWidgetsAreRequired) 設為 true 或透過 Action.addRequiredWidget(requiredWidget) 指定這個小工具，除非選取值，否則系統會封鎖提交動作。
適用於 Google Workspace 外掛程式和 Google Chat 應用程式。
const 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'), );
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
set | Date | 設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。 |
set | Date | 在 Google Workspace 流程中，輸入變數可接受流程中其他步驟的日期時間輸出內容。 |
set | Date | 設定指令碼，在每次選擇器輸入內容變更時執行。Action |
set | Date | 設定時區與世界標準時間的時差 (以分鐘為單位)。 |
set | Date | 設定顯示在輸入欄位上方的標題。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
內容詳盡的說明文件
set
設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。使用者會看到欄位名稱。必填；指定的欄位名稱不得重複。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
field | String | 要指派給這個輸入內容的名稱。 |
回攻員
Date - 這個選擇器用於串連。
set
在 Google Workspace 流程中，輸入變數可接受流程中其他步驟的日期時間輸出內容。例如，接收 Gmail 郵件的傳送時間，或是日曆活動的排定日期。
僅適用於 Gemini Alpha 版計畫，可透過 Google Workspace 外掛程式擴充 Google Workspace Flows。
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
host | Host | 資料來源。 |
回攻員
Date - 這個選擇器用於串連。
set
set
設定時區與世界標準時間的時差 (以分鐘為單位)。如果設定時區，系統會以指定時區顯示日期和時間。如果未設定，系統會以使用者時區顯示時間。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
time | Integer | 時區與世界標準時間的時差 (以分鐘為單位)。 |
回攻員
Date - 這個選擇器用於串連。
set
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | Number | 輸入內容中的預設值，以自 Epoch 紀元時間起算的毫秒數表示。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - 這個選擇器用於串連。
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | String | 輸入內容中預設值 (字串)，以 Epoch 紀元時間起算的毫秒數表示。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - 這個選擇器用於串連。