可讓使用者輸入日期和時間的輸入欄位。
適用於 Google Workspace 外掛程式和 Google Chat 應用程式。
var 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"));
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
setFieldName(fieldName) | DateTimePicker | 設定欄位名稱,用來在有 UI 互動時產生的事件物件中識別這個挑選器。 |
setOnChangeAction(action) | DateTimePicker | 設定當挑選器輸入內容變更時,指令碼會執行的 Action 。 |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | 設定時區應與世界標準時間偏移的分鐘數。 |
setTitle(title) | DateTimePicker | 設定輸入欄位上方顯示的標題。 |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | 設定要在輸入欄位設定的預填值。 |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | 設定要在輸入欄位設定的預填值。 |
內容詳盡的說明文件
setFieldName(fieldName)
設定欄位名稱,用來在有 UI 互動時產生的事件物件中識別這個挑選器。使用者會看到欄位名稱。必填;指定的欄位名稱不得重複。
參數
名稱 | 類型 | 說明 |
---|---|---|
fieldName | String | 要指派給這項輸入內容的名稱。 |
回攻員
DateTimePicker
— 用於鏈結的挑選器。
setOnChangeAction(action)
setTimeZoneOffsetInMins(timeZoneOffsetMins)
設定時區應與世界標準時間偏移的分鐘數。如果設定這個欄位,系統會使用指定時區顯示日期與時間。如果未設定,系統會以使用者的時區顯示時間。
參數
名稱 | 類型 | 說明 |
---|---|---|
timeZoneOffsetMins | Integer | 時區與世界標準時間偏移的分鐘數。 |
回攻員
DateTimePicker
— 用於鏈結的挑選器。
setTitle(title)
setValueInMsSinceEpoch(valueMsEpoch)
設定要在輸入欄位設定的預填值。
參數
名稱 | 類型 | 說明 |
---|---|---|
valueMsEpoch | Number | 輸入內容中的預設值,以數字表示,自 Epoch 紀元時間起算,以毫秒為單位。此名稱一律會在表單回呼參數中以字串表示。 |
回攻員
DateTimePicker
— 用於鏈結的挑選器。
setValueInMsSinceEpoch(valueMsEpoch)
設定要在輸入欄位設定的預填值。
參數
名稱 | 類型 | 說明 |
---|---|---|
valueMsEpoch | String | 輸入內容中的預設值,以字串為單位,自 Epoch 紀元時間起算,以毫秒為單位。此名稱一律會在表單回呼參數中以字串表示。 |
回攻員
DateTimePicker
— 用於鏈結的挑選器。