Ein Eingabefeld, in dem Nutzer ein Datum und eine Uhrzeit eingeben können.
Unterstützt die Validierung von Formulareinsendungen. Wenn Action.setAllWidgetsAreRequired(allWidgetsAreRequired) auf true gesetzt ist oder dieses Widget über Action.addRequiredWidget(requiredWidget) angegeben wird, wird die Aktion zum Senden 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 in dem Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. |
set | Date | In einem Google Workspace Studio-Agenten können Eingabevariablen Datetime-Ausgaben aus anderen Schritten im Agenten akzeptieren. |
set | Widget | Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. |
set | Date | Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ä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
add
Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
event | Event | Die hinzuzufügende Event. |
Rückflug
Widget – Das Objekt für die Verkettung.
set
Legt den Feldnamen fest, der diese Auswahl in dem 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 diesem Eingang zugewiesen werden soll. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
In einem Google Workspace Studio-Agenten können Eingabevariablen Datetime-Ausgaben aus anderen Schritten im Agenten akzeptieren. Sie können 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
Date: Diese Auswahl zur Verkettung.
set
Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. Die Mutation von Widgets wird nur in Add-ons unterstützt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
id | String | Die ID des Widgets mit einem Limit von 64 Zeichen und im Format `[a-zA-Z0-9-]+`. |
Rückflug
Widget: Dieses Objekt zur Verkettung.
set
Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action | Action | Die erforderliche Aktion. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
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 Zeit 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
Date: Diese Auswahl zur Verkettung.
set
Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des Eingabefelds. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
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. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
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. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
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.