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)

在存在界面互动时生成的事件对象中设置用于标识此选择器的字段名称。字段名称对用户可见。必需;指定的字段名称必须是唯一的。

参数

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

弃踢回攻

DateTimePicker - 此选择器,用于实现链。


setOnChangeAction(action)

设置每当选择器输入发生更改时脚本执行的 Action

参数

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

弃踢回攻

DateTimePicker - 此选择器,用于实现链。


setTimeZoneOffsetInMins(timeZoneOffsetMins)

设置时区与世界协调时间 (UTC) 的偏差(分钟数)。如果设置了此字段,则日期和时间将以指定的时区显示。如果未设置,则时间将以用户所在的时区显示。

参数

名称类型说明
timeZoneOffsetMinsInteger时区与世界协调时间 (UTC) 的偏差(分钟数)。

弃踢回攻

DateTimePicker - 此选择器,用于实现链。


setTitle(title)

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

参数

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

弃踢回攻

DateTimePicker - 此选择器,用于实现链。


setValueInMsSinceEpoch(valueMsEpoch)

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

参数

名称类型说明
valueMsEpochNumber输入中的默认值(以数字表示,以毫秒为单位,从 Epoch 起算)。它始终在表单回调参数中表示为字符串。

弃踢回攻

DateTimePicker - 此选择器,用于实现链。


setValueInMsSinceEpoch(valueMsEpoch)

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

参数

名称类型说明
valueMsEpochString以字符串形式存储在输入中的默认值(以毫秒为单位,从 Epoch 起算)。它始终在表单回调参数中表示为字符串。

弃踢回攻

DateTimePicker - 此选择器,用于实现链。