AI-generated Key Takeaways
-
The DateTimePicker is an input field for selecting a date and time, supporting form submission validation.
-
It is available for Google Workspace add-ons and Google Chat apps.
-
Key methods include setting the field name, defining an action on change, setting the time zone offset, setting the title, and setting the default value in milliseconds since the epoch.
An input field that allows users to input a date and time.
Supports form submission validation. When Action.setAllWidgetsAreRequired(allWidgetsAreRequired) is set to
true or this widget is specified through Action.addRequiredWidget(requiredWidget), the submission
action is blocked unless a value is selected.
Available for Google Workspace add-ons and Google Chat apps.
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'), );
Methods
| Method | Return type | Brief description |
|---|---|---|
set | Date | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |
set | Date | Sets an Action that the script performs whenever the picker input changes. |
set | Date | Sets the number of minutes that the time zone should be offset from UTC. |
set | Date | Sets the title displayed above the input field. |
set | Date | Sets the prefilled value to be set in the input field. |
set | Date | 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.
Parameters
| Name | Type | Description |
|---|---|---|
field | String | The name to assign to this input. |
Return
Date — 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
Date — This picker, for chaining.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Sets the number of minutes that the time zone should be offset from UTC. If set, the date and time is displayed in the specified time zone. If not set, the time is displayed in the user's time zone.
Parameters
| Name | Type | Description |
|---|---|---|
time | Integer | The number of minutes that the time zone is offset from UTC. |
Return
Date — 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
Date — This picker, for chaining.
setValueInMsSinceEpoch(valueMsEpoch)
Sets the prefilled value to be set in the input field.
Parameters
| Name | Type | Description |
|---|---|---|
value | Number | The default value placed in the input as a number, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |
Return
Date — This picker, for chaining.
setValueInMsSinceEpoch(valueMsEpoch)
Sets the prefilled value to be set in the input field.
Parameters
| Name | Type | Description |
|---|---|---|
value | String | The default value placed in the input as a string, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |
Return
Date — This picker, for chaining.