Class DatePicker

DatePicker

Ein Eingabefeld, in dem ein Datum eingegeben werden kann.

Verfügbar für Google Workspace-Add-ons und Google Chat-Apps.

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addEventAction(eventAction)	Widget	Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.
setFieldName(fieldName)	DatePicker	Legt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird.
setId(id)	Widget	Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Widgets verwendet wird.
setOnChangeAction(action)	DatePicker	Legt eine Action fest, die das Skript ausführt, wenn sich die Eingabe der Auswahl ändert.
setTitle(title)	DatePicker	Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
setVisibility(visibility)	Widget	Legt die Sichtbarkeit des Widgets fest.

Detaillierte Dokumentation

addEventAction(eventAction)

Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.

Parameter

Name	Typ	Beschreibung
eventAction	EventAction	Das EventAction hinzuzufügen.

Rückflug

Widget – Das Objekt zur Verkettung.

---

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.

Parameter

Name	Typ	Beschreibung
fieldName	String	Der Name, der dieser Eingabe zugewiesen werden soll.

Rückflug

DatePicker – Diese Auswahl zur Verkettung.

---

setId(id)

Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Widgets verwendet wird. Die Widget-Mutation wird nur in Add-ons unterstützt.

Parameter

Name	Typ	Beschreibung
id	String	Die ID des Widgets mit einem Limit von 64 Zeichen im Format `[a-zA-Z0-9-]+`.

Rückflug

Widget – Dieses Objekt zur Verkettung.

---

setOnChangeAction(action)

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

Parameter

Name	Typ	Beschreibung
action	Action	Die erforderliche Aktion.

Rückflug

DatePicker – Diese Auswahl zur Verkettung.

---

setTitle(title)

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

Parameter

Name	Typ	Beschreibung
title	String	Der Titel des Eingabefelds.

Rückflug

DatePicker – Diese Auswahl zur Verkettung.

---

setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

Name	Typ	Beschreibung
valueMsEpoch	Number	Der Standardwert, der als Zahl in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Es wird nur das Datum der Epochenzeit verwendet. Die Uhrzeit der Epochenzeit wird verworfen. Er wird in den Formular-Callback-Parametern immer als String dargestellt.

Rückflug

DatePicker – Diese Auswahl zur Verkettung.

---

setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

Name	Typ	Beschreibung
valueMsEpoch	String	Der Standardwert, der als String in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Es wird nur das Datum der Epochenzeit verwendet. Die Uhrzeit der Epochenzeit wird verworfen. Er wird in den Formular-Callback-Parametern immer als String dargestellt.

Rückflug

DatePicker – Diese Auswahl zur Verkettung.

---

setVisibility(visibility)

Legt die Sichtbarkeit des Widgets fest. Der Standardwert ist `VISIBLE`.

Parameter

Name	Typ	Beschreibung
visibility	Visibility	Die Visibility des Widgets.

Rückflug

Widget – Das Objekt zur Verkettung.