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)

设置在有界面互动时生成的事件对象中用于标识此选择器的字段名称。该字段名称会向用户显示。必需；指定的字段名称必须是唯一的。

参数

名称	类型	说明
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	输入数字中的默认值（以毫秒为单位，从 Epoch 起算）。它在表单回调参数中始终表示为字符串。

返回

DateTimePicker - 此选择器，用于串联。

---

setValueInMsSinceEpoch(valueMsEpoch)

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

参数

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

返回

DateTimePicker - 此选择器，用于串联。