允许输入日期的输入字段。
适用于 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'), );
方法
| 方法 | 返回类型 | 简介 |
|---|---|---|
add | Widget | 添加可在 widget 上执行的事件操作。 |
set | Date | 设置在发生界面互动时生成的事件对象中用于标识相应选择器的字段名称。 |
set | Widget | 设置用于标识要发生变异的 widget 的唯一 ID。 |
set | Date | 设置一个 Action，每当选择器输入发生变化时，脚本都会执行该 Action。 |
set | Date | 设置显示在输入字段上方的标题。 |
set | Date | 设置要在输入字段中设置的预填充值。 |
set | Date | 设置要在输入字段中设置的预填充值。 |
set | Widget | 设置 widget 的可见性。 |
详细文档
add
set
设置在发生界面互动时生成的事件对象中用于标识相应选择器的字段名称。用户会看到字段名称。必需；指定的字段名称必须是唯一的。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
field | String | 要为此输入源分配的名称。 |
返回
Date - 此选择器，用于链式调用。
set
设置用于标识要发生变异的 widget 的唯一 ID。只有在插件中支持 widget 突变。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
id | String | 微件的 ID，长度限制为 64 个字符，格式为 `[a-zA-Z0-9-]+`。 |
返回
Widget - 此对象，用于链式调用。
set
set
set
设置要在输入字段中设置的预填充值。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
value | Number | 放置在输入中的默认值，以自纪元以来的毫秒数表示。仅使用纪元时间的日期，并舍弃纪元时间的时间。在表单回调参数中，它始终表示为字符串。 |
返回
Date - 此选择器，用于链式调用。
set
设置要在输入字段中设置的预填充值。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
value | String | 以字符串形式放置在输入中的默认值，以自纪元开始的毫秒数表示。仅使用纪元时间的日期，并舍弃纪元时间的时间。在表单回调参数中，它始终表示为字符串。 |
返回
Date - 此选择器，用于链式调用。