Class DateTimePicker

DatumUhrzeitAuswahl

Ein Eingabefeld, in das Nutzer ein Datum und eine Uhrzeit eingeben können.

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 im Ereignisobjekt identifiziert, das generiert wird, wenn eine UI-Interaktion stattfindet.
setOnChangeAction(action)DateTimePickerLegt eine Action fest, die das Script ausführt, wenn sich die Eingabe der Auswahl ändert.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerHiermit wird festgelegt, um wie viele Minuten die Zeitzone von UTC abweichen soll.
setTitle(title)DateTimePickerHiermit wird der Titel festgelegt, der über dem Eingabefeld angezeigt wird.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.

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

DateTimePicker – 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

DateTimePicker – Diese Auswahl für die Verkettung.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

Hiermit wird festgelegt, um wie viele Minuten die Zeitzone von UTC abweichen soll. Wenn diese Option festgelegt ist, werden Datum und Uhrzeit in der angegebenen Zeitzone angezeigt. Wenn nicht festgelegt, wird die Uhrzeit in der Zeitzone des Nutzers angezeigt.

Parameter

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

Rückflug

DateTimePicker – 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

DateTimePicker – Diese Auswahl für die Verkettung.


setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

NameTypBeschreibung
valueMsEpochNumberDer Standardwert, der als Zahl in Millisekunden seit der Epoche in die Eingabe eingefügt wird. Sie wird in den Rückrufparametern des Formulars immer als String dargestellt.

Rückflug

DateTimePicker – Diese Auswahl für die Verkettung.


setValueInMsSinceEpoch(valueMsEpoch)

Legt den vorausgefü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 Rückrufparametern des Formulars immer als String dargestellt.

Rückflug

DateTimePicker – Diese Auswahl für die Verkettung.