使用者可在這個輸入欄位輸入日期和時間。
支援表單提交驗證。如果 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'), );
方法
| 方法 | 傳回類型 | 簡短說明 |
|---|---|---|
add | Widget | 新增可在小工具上執行的事件動作。 |
set | Date | 設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。 |
set | Date | 在 Google Workspace Studio 代理程式中，輸入變數可接受代理程式其他步驟的日期時間輸出內容。 |
set | Widget | 設定指派的專屬 ID，用於識別要變動的小工具。 |
set | Date | 設定指令碼，在每次變更挑選器輸入內容時執行。Action |
set | Date | 設定時區與世界標準時間的時差 (以分鐘為單位)。 |
set | Date | 設定顯示在輸入欄位上方的標題。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
set | Date | 設定要在輸入欄位中設定的預填值。 |
set | Widget | 設定小工具的顯示設定。 |
內容詳盡的說明文件
add
set
設定欄位名稱，在發生 UI 互動時產生的事件物件中，識別這個挑選器。使用者會看到欄位名稱。必填，指定的欄位名稱不得重複。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
field | String | 要指派給這個輸入內容的名稱。 |
回攻員
Date - 這個選擇器用於串連。
set
在 Google Workspace Studio 代理程式中，輸入變數可接受代理程式其他步驟的日期時間輸出內容。例如，接收 Gmail 郵件的傳送時間，或是日曆活動的排定日期。
僅適用於擴充 Google Workspace Studio 的 Google Workspace 外掛程式。
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
設定指派的專屬 ID，用於識別要變動的小工具。外掛程式僅支援小工具突變。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
id | String | 小工具的 ID，最多 64 個字元，格式為 `[a-zA-Z0-9-]+`。 |
回攻員
Widget - 這個物件，用於鏈結。
set
set
設定時區與世界標準時間的時差 (以分鐘為單位)。如果已設定，系統會以指定時區顯示日期和時間。如未設定，系統會以使用者時區顯示時間。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
time | Integer | 時區與世界標準時間的時差 (以分鐘為單位)。 |
回攻員
Date - 這個選擇器用於串連。
set
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | Number | 輸入欄位中的預設值，以自 Epoch 紀元時間起算的毫秒數表示。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - 這個選擇器用於串連。
set
設定要在輸入欄位中設定的預填值。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
value | String | 輸入內容中預設值 (以字串形式表示，自 Epoch 紀元時間起算的毫秒數)。在表單回呼參數中，一律以字串表示。 |
回攻員
Date - 這個選擇器用於串連。