此页面由 Cloud Translation API 翻译。

Class DateTimePicker

一个输入字段，供用户输入日期和时间。

支持表单提交验证。当 Action.setAllWidgetsAreRequired(allWidgetsAreRequired) 设置为 true 或通过 Action.addRequiredWidget(requiredWidget) 指定此微件时，除非选择某个值，否则系统会阻止提交操作。

适用于 Google Workspace 插件和 Google Chat 应用。

const 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`	设置要在输入字段中设置的预填充值。

详细文档