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設定在 UI 互動時產生的事件物件中，用於識別此選擇器的欄位名稱。
setOnChangeAction(action)DatePicker設定 Action，當挑選器輸入內容有所變更時，指令碼就會執行。
setTitle(title)DatePicker設定輸入欄位上方顯示的標題。
setValueInMsSinceEpoch(valueMsEpoch)DatePicker設定要設在輸入欄位的預先填入值。
setValueInMsSinceEpoch(valueMsEpoch)DatePicker設定要設在輸入欄位的預先填入值。

內容詳盡的說明文件

setFieldName(fieldName)

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

參數

名稱類型說明
fieldNameString要指派給此輸入內容的名稱。

回攻員

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

setOnChangeAction(action)

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

參數

名稱類型說明
actionAction要採取的動作。

回攻員

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

setTitle(title)

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

參數

名稱類型說明
titleString輸入欄位標題。

回攻員

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

setValueInMsSinceEpoch(valueMsEpoch)

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

參數

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

回攻員

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

setValueInMsSinceEpoch(valueMsEpoch)

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

參數

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

回攻員

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