Ein Eingabefeld, in das Nutzer eine Uhrzeit eingeben können.
Verfügbar für Google Workspace-Add-ons und 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"));
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
setFieldName(fieldName) | TimePicker | Legt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. |
setHours(hours) | TimePicker | Legt den Wert für die vorausgefüllten Stunden fest, der im Eingabefeld festgelegt werden soll. |
setMinutes(minutes) | TimePicker | Legt den vorausgefüllten Minutenwert fest, der im Eingabefeld festgelegt werden soll. |
setOnChangeAction(action) | TimePicker | Legt eine Action fest, die das Skript immer dann ausführt, wenn sich die Auswahleingabe ändert. |
setTitle(title) | TimePicker | Legt den Titel fest, der über dem Eingabefeld angezeigt wird. |
Detaillierte Dokumentation
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.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
fieldName | String | Der Name, der dieser Eingabe zugewiesen werden soll. |
Return
TimePicker: Diese Auswahl dient zur Verkettung.
setHours(hours)
Legt den Wert für die vorausgefüllten Stunden fest, der im Eingabefeld festgelegt werden soll.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
hours | Integer | Der Standard-Stundenwert in der Eingabe. Er liegt zwischen 0 und 23. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Return
TimePicker: Diese Auswahl dient zur Verkettung.
setMinutes(minutes)
Legt den vorausgefüllten Minutenwert fest, der im Eingabefeld festgelegt werden soll.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
minutes | Integer | Der Standardwert für die Minuten in der Eingabe liegt zwischen 0 und 59. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Return
TimePicker: Diese Auswahl dient zur Verkettung.
setOnChangeAction(action)
Legt eine Action fest, die das Skript immer dann ausführt, wenn sich die Auswahleingabe ändert.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
action | Action | Die erforderliche Aktion. |
Return
TimePicker: Diese Auswahl dient zur Verkettung.
setTitle(title)
Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des Eingabefelds. |
Return
TimePicker: Diese Auswahl dient zur Verkettung.