Ein Eingabefeld, in das Nutzer eine Uhrzeit eingeben können.
Verfügbar für Google Workspace-Add‑ons und 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'), );
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
add | Widget | Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann. |
set | Time | Legt den Feldnamen fest, der diese Auswahl in dem Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. |
set | Time | Legt den voreingestellten Stundenwert fest, der im Eingabefeld festgelegt werden soll. |
set | Widget | Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. |
set | Time | Legt den vorab ausgefüllten Wert für die Minuten fest, der im Eingabefeld festgelegt werden soll. |
set | Time | Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert. |
set | Time | Legt den Titel fest, der über dem Eingabefeld angezeigt wird. |
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
Time: Diese Auswahl zur Verkettung.
set
Legt den voreingestellten Stundenwert fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
hours | Integer | Der Standardwert für die Stunde im Eingabefeld liegt zwischen 0 und 23. Sie wird immer als String in den Formular-Callback-Parametern dargestellt. |
Rückflug
Time: 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 den vorab ausgefüllten Wert für die Minuten fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
minutes | Integer | Der Standardwert für Minuten im Eingabefeld liegt zwischen 0 und 59. Sie wird immer als String in den Formular-Callback-Parametern dargestellt. |
Rückflug
Time: Diese Auswahl 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
Time: 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
Time: 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.