Pole do wprowadzania danych, które pozwala użytkownikom podać datę i godzinę.
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"));
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
setFieldName(fieldName) | DateTimePicker | Ustawia nazwę pola, która identyfikuje ten selektor w obiekcie zdarzenia wygenerowanym, gdy wystąpi interakcja z interfejsem. |
setOnChangeAction(action) | DateTimePicker | Ustawia wartość Action, która jest uruchamiana przez skrypt po każdej zmianie danych wejściowych selektora. |
setTimeZoneOffsetInMins(timeZoneOffsetMins) | DateTimePicker | Określa liczbę minut (w minutach) na przesunięcie względem strefy czasowej UTC. |
setTitle(title) | DateTimePicker | Ustawia tytuł wyświetlany nad polem do wprowadzania danych. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Ustawia wstępnie wypełnioną wartość do ustawienia w polu wejściowym. |
setValueInMsSinceEpoch(valueMsEpoch) | DateTimePicker | Ustawia wstępnie wypełnioną wartość do ustawienia w polu wejściowym. |
Szczegółowa dokumentacja
setFieldName(fieldName)
Ustawia nazwę pola, która identyfikuje ten selektor w obiekcie zdarzenia wygenerowanym, gdy wystąpi interakcja z interfejsem. Nazwa pola jest widoczna dla użytkownika. Wymagane; nazwa pola musi być unikalna.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
fieldName | String | Nazwa, którą chcesz przypisać do tego wejścia. |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.
setOnChangeAction(action)
Ustawia wartość Action, która jest uruchamiana przez skrypt po każdej zmianie danych wejściowych selektora.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
action | Action | Działanie, które należy podjąć. |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Określa liczbę minut (w minutach) na przesunięcie względem strefy czasowej UTC. Jeśli jest skonfigurowana, data i godzina są wyświetlane w określonej strefie czasowej. Jeśli jej nie skonfigurujesz, godzina będzie wyświetlana w strefie czasowej użytkownika.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
timeZoneOffsetMins | Integer | Liczba minut w strefie czasowej (w przypadku przesunięcia względem czasu UTC). |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.
setTitle(title)
Ustawia tytuł wyświetlany nad polem do wprowadzania danych.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
title | String | Tytuł pola wprowadzania. |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.
setValueInMsSinceEpoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość do ustawienia w polu wejściowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
valueMsEpoch | Number | Wartość domyślna podana w danych wejściowych w postaci liczby (w milisekundach od początku epoki). Zawsze jest reprezentowany jako ciąg znaków w parametrach wywołania zwrotnego formularza. |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.
setValueInMsSinceEpoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość do ustawienia w polu wejściowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
valueMsEpoch | String | Wartość domyślna podana w danych wejściowych jako ciąg tekstowy (w milisekundach od początku epoki). Zawsze jest reprezentowany jako ciąg znaków w parametrach wywołania zwrotnego formularza. |
Zwróć
DateTimePicker – ten selektor do tworzenia łańcuchów.