Class TimePicker

时间选择器

一个输入字段，供用户输入时间。

适用于 Google Workspace 插件和 Google Chat 应用。 

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

方法

方法返回类型简介
setFieldName(fieldName)TimePicker设置在发生界面互动时生成的事件对象中用于标识此选择器的字段名称。
setHours(hours)TimePicker设置要在输入字段中设置的预先填充的小时数值。
setMinutes(minutes)TimePicker设置要在输入字段中设置的预填充分钟数值。
setOnChangeAction(action)TimePicker设置一个 Action，以便脚本在选择器输入发生变化时执行该操作。
setTitle(title)TimePicker设置显示在输入字段上方的标题。

详细文档

setFieldName(fieldName)

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

参数

名称类型说明
fieldNameString要分配给此输入的名称。

返回

TimePicker - 此选择器，用于链式调用。

setHours(hours)

设置要在输入字段中设置的预先填充的小时数值。

参数

名称类型说明
hoursInteger输入中的默认小时值，范围为 0 到 23。它始终在表单回调参数中表示为字符串。

返回

TimePicker - 此选择器，用于链式调用。

setMinutes(minutes)

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

参数

名称类型说明
minutesInteger输入中的默认分钟值，范围为 0 到 59。它始终在表单回调参数中表示为字符串。

返回

TimePicker - 此选择器，用于链式调用。

setOnChangeAction(action)

设置一个 Action，以便脚本在选择器输入发生变化时执行该操作。

参数

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

返回

TimePicker - 此选择器，用于链式调用。

setTitle(title)

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

参数

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

返回

TimePicker - 此选择器，用于链式调用。