允许用户输入日期和时间的输入字段。
适用于 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)
setTimeZoneOffsetInMins(timeZoneOffsetMins)
设置时区偏离世界协调时间 (UTC) 的分钟数。如果已设置,则 时间以指定的时区显示。如果未设置,时间将显示在用户的 时区。
参数
名称 | 类型 | 说明 |
---|---|---|
timeZoneOffsetMins | Integer | 时区偏离世界协调时间 (UTC) 的分钟数。 |
返回
DateTimePicker
- 此选择器,用于链接。
setTitle(title)
setValueInMsSinceEpoch(valueMsEpoch)
设置要在输入字段中设置的预填充值。
参数
名称 | 类型 | 说明 |
---|---|---|
valueMsEpoch | Number | 输入值中以数字表示的默认值,以毫秒为单位, 周期数。在表单回调参数中,它始终表示为字符串。 |
返回
DateTimePicker
- 此选择器,用于链接。
setValueInMsSinceEpoch(valueMsEpoch)
设置要在输入字段中设置的预填充值。
参数
名称 | 类型 | 说明 |
---|---|---|
valueMsEpoch | String | 作为字符串放置在输入中的默认值,以毫秒为单位, 周期数。在表单回调参数中,它始终表示为字符串。 |
返回
DateTimePicker
- 此选择器,用于链接。