Class DateTimePicker

DateTimePicker

An input field that allows users to input a date and time.

Available for Google Workspace Add-ons and Google Chat apps.

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"));

Methods

Method	Return type	Brief description
`setFieldName(fieldName)`	`DateTimePicker`	Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction.
`setOnChangeAction(action)`	`DateTimePicker`	Sets an `Action` that the script performs whenever the picker input changes.
`setTimeZoneOffsetInMins(timeZoneOffsetMins)`	`DateTimePicker`	Sets the number of minutes that the time zone should be offset from UTC.
`setTitle(title)`	`DateTimePicker`	Sets the title displayed above the input field.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Sets the prefilled value to be set in the input field.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	Sets the prefilled value to be set in the input field.

Detailed documentation

`setFieldName(fieldName)`

Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. The field name is visible to the user. Required; the specified field name must be unique.