本頁面由 Cloud Translation API 翻譯而成。

Class DatePicker

可輸入日期的輸入欄位。

適用於 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'),
        );

方法

方法	傳回類型	簡短說明
`setFieldName(fieldName)`	`DatePicker`	設定在使用者介面互動時產生的事件物件中，用於識別此選擇器的欄位名稱。
`setOnChangeAction(action)`	`DatePicker`	設定 `Action`，當挑選器輸入內容變更時，指令碼就會執行。
`setTitle(title)`	`DatePicker`	設定輸入欄位上方顯示的標題。
`setValueInMsSinceEpoch(valueMsEpoch)`	`DatePicker`	設定要設在輸入欄位的預先填入值。
`setValueInMsSinceEpoch(valueMsEpoch)`	`DatePicker`	設定要設在輸入欄位的預先填入值。

內容詳盡的說明文件

`setFieldName(fieldName)`

設定欄位名稱，用於在使用者介面互動時產生的事件物件中，識別此選擇器。使用者可看見欄位名稱。必填欄位名稱不得重複。

參數

名稱	類型	說明
`fieldName`	`String`	要指派給此輸入來源的名稱。

回攻員

DatePicker：這個選擇器，用於鏈結。

`setOnChangeAction(action)`

設定 Action，當挑選器輸入內容變更時，指令碼就會執行。

參數

名稱	類型	說明
`action`	`Action`	要採取的動作。

回攻員

DatePicker：這個選擇器，用於鏈結。

`setTitle(title)`

設定輸入欄位上方顯示的標題。

參數

名稱	類型	說明
`title`	`String`	輸入欄位標題。

回攻員

DatePicker：這個選擇器，用於鏈結。

`setValueInMsSinceEpoch(valueMsEpoch)`

設定要設在輸入欄位的預先填入值。

參數

名稱	類型	說明
`valueMsEpoch`	`Number`	輸入內容中的預設值為數字，以 Epoch 紀元時間起算的毫秒數為單位。只使用紀元時間的日期，而捨棄紀元時間。在表單回呼參數中，這項屬性一律會以字串表示。

回攻員

DatePicker：這個選擇器，用於鏈結。

`setValueInMsSinceEpoch(valueMsEpoch)`

設定要設在輸入欄位的預先填入值。

參數

名稱	類型	說明
`valueMsEpoch`	`String`	這個預設值會以字串形式放入輸入內容，以 Epoch 紀元時間起算的毫秒數為單位。只使用紀元時間的日期，而捨棄紀元時間。在表單回呼參數中，這項屬性一律會以字串表示。

回攻員

DatePicker：這個選擇器，用於鏈結。