Class TimePicker

TimePicker

An input field that allows users to input a time.

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

 var 
  
 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
TimePicker Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction.
TimePicker Sets the prefilled hours value to set in the input field.
TimePicker Sets the prefilled minutes value to set in the input field.
TimePicker Sets an Action that the script performs whenever the picker input changes.
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.

Parameters

Name Type Description
fieldName
String The name to assign to this input.

Return

TimePicker — This picker, for chaining.


setHours(hours)

Sets the prefilled hours value to set in the input field.

Parameters

Name Type Description
hours
Integer The default hour value placed in the input, range from 0 to 23. It is always represented as a string in the form callback parameters.

Return

TimePicker — This picker, for chaining.


setMinutes(minutes)

Sets the prefilled minutes value to set in the input field.

Parameters

Name Type Description
minutes
Integer The default minutes value placed in the input, range from 0 to 59. It is always represented as a string in the form callback parameters.

Return

TimePicker — This picker, for chaining.


setOnChangeAction(action)

Sets an Action that the script performs whenever the picker input changes.

Parameters

Name Type Description
action
Action The action to take.

Return

TimePicker — This picker, for chaining.


setTitle(title)

Sets the title displayed above the input field.

Parameters

Name Type Description
title
String The input field title.

Return

TimePicker — This picker, for chaining.