Class DateTimePicker

日期时间选择器

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

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

const dateTimePicker =
    CardService.newDateTimePicker()
        .setTitle('Enter the date and time.')
        .setFieldName('date_time_field')
        // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or
        // string is acceptable.
        .setValueInMsSinceEpoch(1514775600)
        // EDT time is 5 hours behind UTC.
        .setTimeZoneOffsetInMins(-5 * 60)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

方法

方法	返回类型	简介
setFieldName(fieldName)	DateTimePicker	设置在发生界面互动时生成的事件对象中用于标识此选择器的字段名称。
setOnChangeAction(action)	DateTimePicker	设置一个 Action，以便脚本在选择器输入发生变化时执行该操作。
setTimeZoneOffsetInMins(timeZoneOffsetMins)	DateTimePicker	设置时区相对于世界协调时间 (UTC) 的偏移分钟数。
setTitle(title)	DateTimePicker	设置显示在输入字段上方的标题。
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	设置要在输入字段中设置的预填充值。
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	设置要在输入字段中设置的预填充值。

详细文档

setFieldName(fieldName)

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

参数

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

返回

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

---

setOnChangeAction(action)

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

参数

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

返回

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

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

设置时区相对于世界协调时间 (UTC) 的偏移分钟数。如果设置了此属性，系统会以指定时区显示日期和时间。如果未设置，则时间会显示在用户的时区。

参数

名称	类型	说明
timeZoneOffsetMins	Integer	时区相对于世界协调时间 (UTC) 的偏移分钟数。

返回

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

---

setTitle(title)

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

参数

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

返回

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

---

setValueInMsSinceEpoch(valueMsEpoch)

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

参数

名称	类型	说明
valueMsEpoch	Number	放入输入中的默认值，以数字形式表示（以毫秒为单位，从纪元起算）。它始终在表单回调参数中表示为字符串。

返回

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

---

setValueInMsSinceEpoch(valueMsEpoch)

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

参数

名称	类型	说明
valueMsEpoch	String	作为字符串放入输入中的默认值，以自公元纪年起的毫秒数表示。它始终在表单回调参数中表示为字符串。

返回

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