Class DateTimePicker

DateTimePicker

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

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

MethodeRückgabetypKurzbeschreibung
setFieldName(fieldName)DateTimePickerLegt den Feldnamen fest, der diese Auswahl im Ereignisobjekt identifiziert, das bei einer UI-Interaktion generiert wird.
setOnChangeAction(action)DateTimePickerLegt eine Action fest, die das Skript immer dann ausführt, wenn sich die Eingabe in der Auswahl ändert.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerLegt die Anzahl der Minuten fest, um die die Zeitzone von der UTC abweichen soll.
setTitle(title)DateTimePickerLegt den Titel fest, der über dem Eingabefeld angezeigt wird.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt den vorausgefüllten Wert fest, der im Eingabefeld festgelegt werden soll.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerLegt 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.

Parameter

NameTypBeschreibung
fieldNameStringDer Name, der diesem Eingang 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 Eingabe in der Auswahl ändert.

Parameter

NameTypBeschreibung
actionActionDie 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 nicht festgelegt, wird die Zeit in der Zeitzone des Nutzers angezeigt.

Parameter

NameTypBeschreibung
timeZoneOffsetMinsIntegerDie Anzahl der Minuten, um die die Zeitzone von UTC abweicht.

Return

DateTimePicker: Diese Auswahl dient zur Verkettung.


setTitle(title)

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

Parameter

NameTypBeschreibung
titleStringDer Titel des Eingabefelds.

Return

DateTimePicker: Diese Auswahl dient zur Verkettung.


setValueInMsSinceEpoch(valueMsEpoch)

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

Parameter

NameTypBeschreibung
valueMsEpochNumberDer Standardwert in der Eingabe als Zahl in Millisekunden seit der Epoche. Sie wird in den Formular-Callback-Parametern 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.

Parameter

NameTypBeschreibung
valueMsEpochStringDer Standardwert in der Eingabe als String, in Millisekunden seit der Epoche. Sie wird in den Formular-Callback-Parametern immer als String dargestellt.

Return

DateTimePicker: Diese Auswahl dient zur Verkettung.