Class TimePicker

An input field that allows users to input a time.

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

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Methods

Method	Return type	Brief description
`setFieldName(fieldName)`	`TimePicker`	Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction.
`setHours(hours)`	`TimePicker`	Sets the prefilled hours value to set in the input field.
`setMinutes(minutes)`	`TimePicker`	Sets the prefilled minutes value to set in the input field.
`setOnChangeAction(action)`	`TimePicker`	Sets an `Action` that the script performs whenever the picker input changes.
`setTitle(title)`	`TimePicker`	Sets the title displayed above 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.