Class DateTimePicker

DatumUhrzeitAuswahl

Ein Eingabefeld, in das 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

MethodeRückgabetypKurzbeschreibung
setFieldName(fieldName)DateTimePickerLegt den Feldnamen fest, der diese Auswahl in dem Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird.
setHostAppDataSource(hostAppDataSource)DateTimePickerIn einem Google Workspace-Ablauf können Eingabevariablen Datetime-Ausgaben aus anderen Schritten im Ablauf akzeptieren.
setOnChangeAction(action)DateTimePickerLegt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerLegt die Anzahl der Minuten fest, um die die Zeitzone von UTC abweichen soll.
setTitle(title)DateTimePickerLegt den Titel fest, der über dem Eingabefeld angezeigt wird.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.

Detaillierte Dokumentation

setFieldName(fieldName)

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

NameTypBeschreibung
fieldNameStringDer Name, der diesem Eingang zugewiesen werden soll.

Rückflug

DateTimePicker – Diese Auswahl zur Verkettung.

setHostAppDataSource(hostAppDataSource)

In einem Google Workspace-Ablauf können Eingabevariablen Datetime-Ausgaben aus anderen Schritten im Ablauf 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 über das Gemini Alpha-Programm für Google Workspace-Add‑ons verfügbar, die Google Workspace Flows 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

NameTypBeschreibung
hostAppDataSourceHostAppDataSourceDie Datenquelle.

Rückflug

DateTimePicker – Diese Auswahl zur Verkettung.

setOnChangeAction(action)

Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert.

Parameter

NameTypBeschreibung
actionActionDie erforderliche Aktion.

Rückflug

DateTimePicker – Diese Auswahl zur 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 Zeit in der Zeitzone des Nutzers angezeigt.

Parameter

NameTypBeschreibung
timeZoneOffsetMinsIntegerDie Anzahl der Minuten, um die die Zeitzone von UTC abweicht.

Rückflug

DateTimePicker – Diese Auswahl zur Verkettung.

setTitle(title)

Legt den Titel fest, der über dem Eingabefeld angezeigt wird.

Parameter

NameTypBeschreibung
titleStringDer Titel des Eingabefelds.

Rückflug

DateTimePicker – Diese Auswahl zur Verkettung.

setValueInMsSinceEpoch(valueMsEpoch)

Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.

Parameter

NameTypBeschreibung
valueMsEpochNumberDer 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

DateTimePicker – Diese Auswahl zur Verkettung.

setValueInMsSinceEpoch(valueMsEpoch)

Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.

Parameter

NameTypBeschreibung
valueMsEpochStringDer 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

DateTimePicker – Diese Auswahl zur Verkettung.