Class TimePicker

Uhrzeitauswahl

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

MethodeRückgabetypKurzbeschreibung
setFieldName(fieldName)TimePickerLegt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das generiert wird, wenn eine UI-Interaktion stattfindet.
setHours(hours)TimePickerLegt den im Eingabefeld vorausgefüllten Wert für die Stunden fest.
setMinutes(minutes)TimePickerLegt den voreingestellten Minutenwert fest, der im Eingabefeld festgelegt werden soll.
setOnChangeAction(action)TimePickerLegt eine Action fest, die das Script ausführt, wenn sich die Eingabe der Auswahl ändert.
setTitle(title)TimePickerHiermit wird der Titel festgelegt, der über dem Eingabefeld angezeigt wird.

Detaillierte Dokumentation

setFieldName(fieldName)

Legt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das generiert wird, wenn eine UI-Interaktion stattfindet. Der Feldname ist für den Nutzer sichtbar. Erforderlich. Der angegebene Feldname muss eindeutig sein.

Parameter

NameTypBeschreibung
fieldNameStringDer Name, der dieser Eingabe zugewiesen werden soll.

Rückflug

TimePicker – Diese Auswahl für die Verkettung.


setHours(hours)

Legt den im Eingabefeld vorausgefüllten Wert für die Stunden fest.

Parameter

NameTypBeschreibung
hoursIntegerDer Standardwert für die Stunde in der Eingabe kann zwischen 0 und 23 liegen. Sie wird in den Rückrufparametern des Formulars immer als String dargestellt.

Rückflug

TimePicker – Diese Auswahl für die Verkettung.


setMinutes(minutes)

Legt den voreingestellten Minutenwert fest, der im Eingabefeld festgelegt werden soll.

Parameter

NameTypBeschreibung
minutesIntegerDer Standardwert für Minuten in der Eingabe kann zwischen 0 und 59 liegen. Sie wird in den Rückrufparametern des Formulars immer als String dargestellt.

Rückflug

TimePicker – Diese Auswahl für die Verkettung.


setOnChangeAction(action)

Legt eine Action fest, die das Script ausführt, wenn sich die Eingabe der Auswahl ändert.

Parameter

NameTypBeschreibung
actionActionDie erforderliche Aktion.

Rückflug

TimePicker – Diese Auswahl für die Verkettung.


setTitle(title)

Hiermit wird der Titel festgelegt, der über dem Eingabefeld angezeigt wird.

Parameter

NameTypBeschreibung
titleStringDer Titel des Eingabefelds.

Rückflug

TimePicker – Diese Auswahl für die Verkettung.