Ein Eingabefeld, in dem Nutzer ein Datum und eine Uhrzeit eingeben können.
Unterstützt die Validierung der Formularübermittlung. Wenn Action.setAllWidgetsAreRequired(allWidgetsAreRequired) auf true gesetzt ist oder dieses Widget über Action.addRequiredWidget(requiredWidget) angegeben wird, wird die Übermittlungsaktion blockiert, sofern kein Wert ausgewählt ist.
Verfügbar für Google Workspace-Add-ons und 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'), );
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
add | Widget | Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann. |
set | Date | Legt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. |
set | Date | Ermöglicht es in einem Google Workspace Studio-Agenten, dass Eingabe variablen Datums- und Uhrzeitausgaben aus anderen Schritten im Agenten akzeptieren. |
set | Widget | Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Widgets verwendet wird. |
set | Date | Legt eine Action fest, die das Skript ausführt, wenn sich die Auswahl ändert. |
set | Date | Legt die Anzahl der Minuten fest, um die die Zeitzone von UTC abweichen soll. |
set | Date | Legt den Titel fest, der über dem Eingabefeld angezeigt wird. |
set | Date | Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll. |
set | Date | Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll. |
set | Widget | Legt die Sichtbarkeit des Widgets fest. |
Detaillierte Dokumentation
addEventAction(eventAction)
Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
event | Event | Das Event hinzuzufügen. |
Rückflug
Widget – Das Objekt für die Verkettung.
setFieldName(fieldName)
Legt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. Der Feldname ist für den Nutzer sichtbar. Erforderlich. Der angegebene Feldname muss eindeutig sein.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
field | String | Der Name, der dieser Eingabe zugewiesen werden soll. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setHostAppDataSource(hostAppDataSource)
Ermöglicht es in einem Google Workspace Studio-Agenten, dass Eingabe variablen Datums- und Uhrzeitausgaben aus anderen Schritten im Agenten akzeptieren. So können Sie beispielsweise die Uhrzeit abrufen, zu der eine Gmail-Nachricht gesendet wurde, oder das Datum, an dem ein Kalendertermin geplant ist.
Nur für Google Workspace-Add-ons verfügbar, die Google Workspace Studio erweitern.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
host | Host | Die Datenquelle. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setId(id)
Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Widgets verwendet wird. Die Widget-Mutation wird nur in Add-ons unterstützt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
id | String | Die ID des Widgets mit einem Limit von 64 Zeichen im Format `[a-zA-Z0-9-]+`. |
Rückflug
Widget – Dieses Objekt für die Verkettung.
setOnChangeAction(action)
Legt eine Action fest, die das Skript ausführt, wenn sich die Auswahl ändert.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action | Action | Die erforderliche Aktion. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Legt die Anzahl der Minuten fest, um die die Zeitzone von UTC abweichen soll. Wenn festgelegt, werden Datum und Uhrzeit in der angegebenen Zeitzone angezeigt. Wenn nicht festgelegt, wird die Uhrzeit in der Zeitzone des Nutzers angezeigt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
time | Integer | Die Anzahl der Minuten, um die die Zeitzone von UTC abweicht. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setTitle(title)
Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des Eingabefelds. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setValueInMsSinceEpoch(valueMsEpoch)
Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
value | Number | Der Standardwert, der als Zahl in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Er wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setValueInMsSinceEpoch(valueMsEpoch)
Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
value | String | Der Standardwert, der als String in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Er wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
DateTimePicker – Diese Auswahl für die Verkettung.
setVisibility(visibility)
Legt die Sichtbarkeit des Widgets fest. Der Standardwert ist `VISIBLE`.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
visibility | Visibility | Die Visibility des Widgets. |
Rückflug
Widget – Das Objekt für die Verkettung.