Class DatePicker

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

方法

方法	返回值类型	简介
addEventAction(eventAction)	Widget	添加可在微件上执行的事件操作。
setFieldName(fieldName)	DatePicker	设置字段名称，用于在发生界面互动时生成的事件对象中标识此选择器。
setId(id)	Widget	设置分配的唯一 ID，用于标识要发生变化的微件。
setOnChangeAction(action)	DatePicker	设置一个 Action，每当选择器输入发生变化时，脚本都会执行该操作。
setTitle(title)	DatePicker	设置显示在输入字段上方的标题。
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	设置要在输入字段中设置的预填充值。
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	设置要在输入字段中设置的预填充值。
setVisibility(visibility)	Widget	设置微件的可见性。

详细文档

addEventAction(eventAction)

添加可在微件上执行的事件操作。

参数

名称	类型	说明
eventAction	EventAction	要添加的 EventAction。

返回

Widget - 用于链式调用的对象。

---

setFieldName(fieldName)

设置字段名称，用于在发生界面互动时生成的事件对象中标识此选择器。用户可以看到字段名称。必需；指定的字段名称必须是唯一的。

参数

名称	类型	说明
fieldName	String	要为此输入分配的名称。

返回

DatePicker - 用于链式调用的此选择器。

---

setId(id)

设置分配的唯一 ID，用于标识要发生变化的微件。只有在插件中才支持微件变化。

参数

名称	类型	说明
id	String	微件的 ID，长度上限为 64 个字符，格式为 `[a-zA-Z0-9-]+`。

返回

Widget - 用于链式调用的此对象。

---

setOnChangeAction(action)

设置一个 Action，每当选择器输入发生变化时，脚本都会执行该操作。

参数

名称	类型	说明
action	Action	要执行的操作。

返回

DatePicker - 用于链式调用的此选择器。

---

setTitle(title)

设置显示在输入字段上方的标题。

参数

名称	类型	说明
title	String	输入字段标题。

返回

DatePicker - 用于链式调用的此选择器。

---

setValueInMsSinceEpoch(valueMsEpoch)

设置要在输入字段中设置的预填充值。

参数

名称	类型	说明
valueMsEpoch	Number	输入中放置的默认值，以数字形式表示，以毫秒为单位，从 纪元起算。仅使用纪元时间中的日期，纪元时间中的时间会被 舍弃。它始终以回调参数的形式表示为字符串。

返回

DatePicker - 用于链式调用的此选择器。

---

setValueInMsSinceEpoch(valueMsEpoch)

设置要在输入字段中设置的预填充值。

参数

名称	类型	说明
valueMsEpoch	String	输入中放置的默认值，以字符串形式表示，以毫秒为单位，从 纪元起算。仅使用纪元时间中的日期，纪元时间中的时间会被 舍弃。它始终以回调参数的形式表示为字符串。

返回

DatePicker - 用于链式调用的此选择器。

---

setVisibility(visibility)

设置微件的可见性。默认值为 `VISIBLE`。

参数

名称	类型	说明
visibility	Visibility	微件的 Visibility。

返回

Widget - 用于链式调用的对象。