可讓使用者輸入日期和時間的輸入欄位。
適用於 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 | 設定在使用者介面互動時產生的事件物件中,用於識別此選擇器的欄位名稱。 |
set | Date | 設定 Action ,當挑選器輸入內容變更時,指令碼就會執行。 |
set | Date | 設定時區與世界標準時間 (UTC) 的偏差分鐘數。 |
set | Date | 設定輸入欄位上方顯示的標題。 |
set | Date | 設定要設在輸入欄位的預先填入值。 |
set | Date | 設定要設在輸入欄位的預先填入值。 |
內容詳盡的說明文件
set Field Name(fieldName)
設定欄位名稱,用於在使用者介面互動時產生的事件物件中,識別此選擇器。使用者可看見欄位名稱。必填欄位名稱不得重複。
參數
名稱 | 類型 | 說明 |
---|---|---|
field | String | 要指派給此輸入來源的名稱。 |
回攻員
Date
:這個選擇器,用於鏈結。
set On Change Action(action)
set Time Zone Offset In Mins(timeZoneOffsetMins)
設定時區與世界標準時間 (UTC) 的偏差分鐘數。如果已設定,日期和時間就會以指定時區顯示。如果未設定,系統會以使用者所在時區顯示時間。
參數
名稱 | 類型 | 說明 |
---|---|---|
time | Integer | 時區與世界標準時間的偏差分鐘數。 |
回攻員
Date
:這個選擇器,用於鏈結。
set Title(title)
set Value In Ms Since Epoch(valueMsEpoch)
設定要設在輸入欄位的預先填入值。
參數
名稱 | 類型 | 說明 |
---|---|---|
value | Number | 輸入內容中的預設值為數字,以 Epoch 紀元時間起算的毫秒數為單位。在表單回呼參數中,這項屬性一律會以字串表示。 |
回攻員
Date
:這個選擇器,用於鏈結。
set Value In Ms Since Epoch(valueMsEpoch)
設定要設在輸入欄位的預先填入值。
參數
名稱 | 類型 | 說明 |
---|---|---|
value | String | 這個預設值會以字串形式放入輸入內容,以 Epoch 紀元時間起算的毫秒數為單位。在表單回呼參數中,這項屬性一律會以字串表示。 |
回攻員
Date
:這個選擇器,用於鏈結。