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.
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 generiert wird, wenn erfolgt eine Interaktion auf der Benutzeroberfläche. |
setOnChangeAction(action) | DateTimePicker | Legt einen Action fest, der vom Skript ausgeführt wird, wenn sich die Auswahl durch die Eingabe ändert. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Legt die Anzahl der Minuten fest, um die die Zeitzone von der UTC verschoben werden 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 generiert wird, wenn erfolgt eine Interaktion auf der Benutzeroberfläche. Der Feldname ist für den Nutzer sichtbar. Erforderlich; das angegebene Feld Name muss eindeutig sein.
Parameter
Name | Typ | Beschreibung |
---|---|---|
fieldName | String | Der Name, der diesem Eingang zugewiesen werden soll. |
Rückflug
DateTimePicker
: Diese Auswahl für die Verkettung.
setOnChangeAction(action)
Legt einen Action
fest, der vom Skript ausgeführt wird, wenn sich die Auswahl durch die Eingabe ändert.
Parameter
Name | Typ | Beschreibung |
---|---|---|
action | Action | Die erforderliche Aktion. |
Rückflug
DateTimePicker
: Diese Auswahl für die Verkettung.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Legt die Anzahl der Minuten fest, um die die Zeitzone von der UTC verschoben werden soll. Wenn festgelegt, werden das Datum und wird in der angegebenen Zeitzone angezeigt. Ist die Richtlinie nicht konfiguriert, wird die Zeit im Feld Zeitzone.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timeZoneOffsetMins | Integer | Die Anzahl der Minuten, um die die Zeitzone von der UTC abweicht. |
Rückflug
DateTimePicker
: Diese Auswahl für die 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
DateTimePicker
: Diese Auswahl für die Verkettung.
setValueInMsSinceEpoch(valueMsEpoch)
Legt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
Parameter
Name | Typ | Beschreibung |
---|---|---|
valueMsEpoch | Number | Der Standardwert, der in der Eingabe als Zahl platziert wird, in Millisekunden seit die Epoche. Er wird in den Formular-Callback-Parametern 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
Name | Typ | Beschreibung |
---|---|---|
valueMsEpoch | String | Der Standardwert, der in der Eingabe als String platziert wird, in Millisekunden seit die Epoche. Er wird in den Formular-Callback-Parametern immer als String dargestellt. |
Rückflug
DateTimePicker
: Diese Auswahl für die Verkettung.