Class DateTimePicker

DateTimePicker

允许用户输入日期和时间的输入字段。

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

var 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 - 此选择器，用于链接。