Class DateTimePicker

DataCzasSelektor

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

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

const 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

MetodaZwracany typKrótki opis
setFieldName(fieldName)DateTimePickerUstawia nazwę pola, która identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem użytkownika.
setOnChangeAction(action)DateTimePickerUstawia funkcję Action, którą skrypt wykonuje, gdy zmienia się dane wejściowe selektora.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerOkreśla liczbę minut, o jaką strefa czasowa ma się przesunąć względem czasu UTC.
setTitle(title)DateTimePickerUstawia tytuł wyświetlany nad polem wprowadzania danych.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerUstawia wstępnie wypełnioną wartość w polu tekstowym.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerUstawia wstępnie wypełnioną wartość w polu tekstowym.

Szczegółowa dokumentacja

setFieldName(fieldName)

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

Parametry

NazwaTypOpis
fieldNameStringNazwa do przypisania temu wejściu.

Powrót

DateTimePicker – ten selektor do łańcuchowania.


setOnChangeAction(action)

Ustawia funkcję Action, którą skrypt wykonuje, gdy zmienia się dane wejściowe selektora.

Parametry

NazwaTypOpis
actionActionDziałanie do wykonania.

Powrót

DateTimePicker – ten selektor do łańcuchowania.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

Określa liczbę minut, o jaką strefa czasowa ma się przesunąć względem czasu UTC. Jeśli jest ustawiona, data i godzina są wyświetlane w wybranej strefie czasowej. Jeśli nie jest ustawiona, czas jest wyświetlany w strefie czasowej użytkownika.

Parametry

NazwaTypOpis
timeZoneOffsetMinsIntegerLiczba minut, o którą strefa czasowa jest przesunięta względem UTC.

Powrót

DateTimePicker – ten selektor do łańcuchowania.


setTitle(title)

Ustawia tytuł wyświetlany nad polem wprowadzania danych.

Parametry

NazwaTypOpis
titleStringTytuł pola danych.

Powrót

DateTimePicker – ten selektor do łańcuchowania.


setValueInMsSinceEpoch(valueMsEpoch)

Ustawia wstępnie wypełnioną wartość w polu tekstowym.

Parametry

NazwaTypOpis
valueMsEpochNumberWartość domyślna podana w danych jako liczba w milisekundach od początku epoki. Jest on zawsze reprezentowany jako ciąg tekstowy w parametrach funkcji wywołania zwrotnego.

Powrót

DateTimePicker – ten selektor do łańcuchowania.


setValueInMsSinceEpoch(valueMsEpoch)

Ustawia wstępnie wypełnioną wartość w polu tekstowym.

Parametry

NazwaTypOpis
valueMsEpochStringWartość domyślna umieszczona w danych wejściowych jako ciąg znaków w milisekundach od początku epoki. Jest on zawsze reprezentowany jako ciąg tekstowy w parametrach funkcji wywołania zwrotnego.

Powrót

DateTimePicker – ten selektor do łańcuchowania.