Class TimePicker

Selektorgodziny

Pole do wprowadzania danych, które umożliwia użytkownikom wpisanie godziny.

Dostępne w przypadku dodatków do Google Workspace i aplikacji do Google Chat.

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

Metody

MetodaZwracany typKrótki opis
addEventAction(eventAction)WidgetDodaje działanie związane z wydarzeniem, które można wykonać w widżecie.
setFieldName(fieldName)TimePickerUstawia nazwę pola, które identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem.
setHours(hours)TimePickerUstawia wstępnie wypełnioną wartość godzin, która ma zostać ustawiona w polu wejściowym.
setId(id)WidgetUstawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony.
setMinutes(minutes)TimePickerUstawia wstępnie wypełnioną wartość w minutach, która ma zostać wpisana w polu.
setOnChangeAction(action)TimePickerUstawia Action, które skrypt wykonuje za każdym razem, gdy zmienia się dane wejściowe selektora.
setTitle(title)TimePickerUstawia tytuł wyświetlany nad polem wprowadzania.
setVisibility(visibility)WidgetUstawia widoczność widżetu.

Szczegółowa dokumentacja

addEventAction(eventAction)

Dodaje działanie związane z wydarzeniem, które można wykonać w widżecie.

Parametry

NazwaTypOpis
eventActionEventActionEventAction do dodania.

Powrót

Widget – obiekt do łączenia.


setFieldName(fieldName)

Ustawia nazwę pola, które identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem. Nazwa pola jest widoczna dla użytkownika. Wymagane; podana nazwa pola musi być niepowtarzalna.

Parametry

NazwaTypOpis
fieldNameStringNazwa, którą chcesz przypisać do tego wejścia.

Powrót

TimePicker – ten selektor do łączenia.


setHours(hours)

Ustawia wstępnie wypełnioną wartość godzin, która ma zostać ustawiona w polu wejściowym.

Parametry

NazwaTypOpis
hoursIntegerDomyślna wartość godziny umieszczona w polu wejściowym, zakres od 0 do 23. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy.

Powrót

TimePicker – ten selektor do łączenia.


setId(id)

Ustawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony. Modyfikacja widżetu jest obsługiwana tylko w dodatkach.

Parametry

NazwaTypOpis
idStringIdentyfikator widżetu, który może mieć maksymalnie 64 znaki i musi być zgodny z formatem `[a-zA-Z0-9-]+`.

Powrót

Widget – ten obiekt do łączenia.


setMinutes(minutes)

Ustawia wstępnie wypełnioną wartość w minutach, która ma zostać wpisana w polu.

Parametry

NazwaTypOpis
minutesIntegerDomyślna wartość minut wpisana w polu mieści się w zakresie od 0 do 59. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy.

Powrót

TimePicker – ten selektor do łączenia.


setOnChangeAction(action)

Ustawia Action, które skrypt wykonuje za każdym razem, gdy zmienia się dane wejściowe selektora.

Parametry

NazwaTypOpis
actionActionDziałanie do wykonania.

Powrót

TimePicker – ten selektor do łączenia.


setTitle(title)

Ustawia tytuł wyświetlany nad polem wprowadzania.

Parametry

NazwaTypOpis
titleStringTytuł pola do wprowadzania danych.

Powrót

TimePicker – ten selektor do łączenia.


setVisibility(visibility)

Ustawia widoczność widżetu. Wartością domyślną jest „VISIBLE”.

Parametry

NazwaTypOpis
visibilityVisibilityVisibility widżetu.

Powrót

Widget – obiekt do łączenia.