Diese Seite wurde von der Cloud Translation API übersetzt.

Class DateTimePicker

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

Unterstützt die Validierung von Formulareinreichungen. Wenn Action.setAllWidgetsAreRequired(allWidgetsAreRequired) auf true gesetzt ist oder dieses Widget über Action.addRequiredWidget(requiredWidget) angegeben wird, wird die Übermittlung blockiert, es sei denn, ein Wert wird ausgewählt.

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

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