Ein Eingabefeld, in das Nutzer Datum und Uhrzeit eingeben können.
Verfügbar für Google Workspace-Add-ons und Google Chat-Apps.
var 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 bei einer UI-Interaktion generiert wird. |
setOnChangeAction(action) | DateTimePicker | Legt eine Action fest, die das Skript immer dann ausführt, wenn sich die Auswahleingabe ändert. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Legt die Anzahl der Minuten fest, um die die Zeitzone von der UTC abweichen soll. |
setTitle(title) | DateTimePicker | Legt den Titel fest, 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 bei einer UI-Interaktion generiert wird. Der Feldname ist für den Nutzer sichtbar. Erforderlich; der angegebene Feldname muss eindeutig sein.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
fieldName | String | Der Name, der dieser Eingabe zugewiesen werden soll. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.
setOnChangeAction(action)
Legt eine Action fest, die das Skript immer dann ausführt, wenn sich die Auswahleingabe ändert.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
action | Action | Die erforderliche Aktion. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Legt die Anzahl der Minuten fest, um die die Zeitzone von der UTC abweichen soll. Wenn festgelegt, werden Datum und Uhrzeit in der angegebenen Zeitzone angezeigt. Wenn nichts festgelegt ist, wird die Zeit in der Zeitzone des Nutzers angezeigt.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
timeZoneOffsetMins | Integer | Die Anzahl der Minuten, um die die Zeitzone von der UTC abweicht. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.
setTitle(title)
Legt den Titel fest, der über dem Eingabefeld angezeigt wird.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
title | String | Der Titel des Eingabefelds. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.
setValueInMsSinceEpoch(valueMsEpoch)
Legt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
valueMsEpoch | Number | Der Standardwert in der Eingabe als Zahl in Millisekunden seit der Epoche. Er wird in den Callback-Parametern in Form immer als String dargestellt. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.
setValueInMsSinceEpoch(valueMsEpoch)
Legt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameters
| Name | Typ | Beschreibung |
|---|---|---|
valueMsEpoch | String | Der Standardwert in der Eingabe als String in Millisekunden seit der Epoche. Er wird in den Callback-Parametern in Form immer als String dargestellt. |
Return
DateTimePicker: Diese Auswahl dient zur Verkettung.