Class DateTimePicker

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
日期选择器

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

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 - 此选择器,用于串联。