一个允许用户输入日期和时间的输入字段。
适用于 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 | 输入中的默认值(以数字表示,以毫秒为单位,从 Epoch 起算)。它始终在表单回调参数中表示为字符串。 |
弃踢回攻
DateTimePicker
- 此选择器,用于实现链。
setValueInMsSinceEpoch(valueMsEpoch)
设置要在输入字段中设置的预填充值。
参数
名称 | 类型 | 说明 |
---|---|---|
valueMsEpoch | String | 以字符串形式存储在输入中的默认值(以毫秒为单位,从 Epoch 起算)。它始终在表单回调参数中表示为字符串。 |
弃踢回攻
DateTimePicker
- 此选择器,用于实现链。