Ein Eingabefeld, in das 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 |
|---|---|---|
add | Widget | Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann. |
set | Date | Legt den Feldnamen fest, der diese Auswahl in dem Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird. |
set | Widget | Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. |
set | Date | Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert. |
set | Date | Legt den Titel fest, der über dem Eingabefeld angezeigt wird. |
set | Date | Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll. |
set | Date | Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll. |
set | Widget | Legt die Sichtbarkeit des Widgets fest. |
Detaillierte Dokumentation
add
Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
event | Event | Die hinzuzufügende Event. |
Rückflug
Widget – Das Objekt für die Verkettung.
set
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
| Name | Typ | Beschreibung |
|---|---|---|
field | String | Der Name, der diesem Eingang zugewiesen werden soll. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. Die Mutation von Widgets wird nur in Add-ons unterstützt.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
id | String | Die ID des Widgets mit einem Limit von 64 Zeichen und im Format `[a-zA-Z0-9-]+`. |
Rückflug
Widget – Dieses Objekt zur Verkettung.
set
Legt eine Action fest, die vom Skript ausgeführt wird, wenn sich die Picker-Eingabe ändert.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action | Action | Die erforderliche Aktion. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des Eingabefelds. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
value | Number | Der Standardwert, der als Zahl in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Es wird nur das Datum der Epoch-Zeit verwendet. Die Uhrzeit der Epoch-Zeit wird verworfen. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
Date – Diese Auswahl zur Verkettung.
set
Legt den vorab ausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
value | String | Der Standardwert, der als String in die Eingabe eingefügt wird, in Millisekunden seit der Epoche. Es wird nur das Datum der Epoch-Zeit verwendet. Die Uhrzeit der Epoch-Zeit wird verworfen. Sie wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
Date: Diese Auswahl zur Verkettung.
set
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 für die Verkettung.