Class DateTimePicker

Selektordatyi godziny

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

Obsługuje weryfikację przesłanych formularzy. Gdy parametr Action.setAllWidgetsAreRequired(allWidgetsAreRequired) ma wartość true lub ten widżet jest określony za pomocą parametru Action.addRequiredWidget(requiredWidget), przesyłanie jest blokowane, chyba że zostanie wybrana wartość.

Dostępne w przypadku dodatków do Google Workspace i aplikacji do 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óre identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem.
setHostAppDataSource(hostAppDataSource)DateTimePickerW przepływie Google Workspace umożliwia zmiennym wejściowym akceptowanie danych wyjściowych daty i godziny z innych kroków przepływu.
setOnChangeAction(action)DateTimePickerUstawia Action, które skrypt wykonuje za każdym razem, gdy zmienia się dane wejściowe selektora.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerUstawia liczbę minut, o którą strefa czasowa powinna być przesunięta względem czasu UTC.
setTitle(title)DateTimePickerUstawia tytuł wyświetlany nad polem wprowadzania.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerUstawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerUstawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym.

Szczegółowa dokumentacja

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ć unikalna.

Parametry

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

Powrót

DateTimePicker – ten selektor do łączenia.

setHostAppDataSource(hostAppDataSource)

W przepływie Google Workspace umożliwia zmiennym wejściowym akceptowanie danych wyjściowych daty i godziny z innych kroków przepływu. Możesz na przykład otrzymać informację o godzinie wysłania wiadomości w Gmailu lub dacie zaplanowania wydarzenia w Kalendarzu.

Dostępne tylko w ramach programu Gemini w wersji alfa dla dodatków do Google Workspace, które rozszerzają funkcje Google Workspace Flows. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

Parametry

NazwaTypOpis
hostAppDataSourceHostAppDataSourceŹródło danych.

Powrót

DateTimePicker – 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

DateTimePicker – ten selektor do łączenia.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Ustawia liczbę minut, o którą strefa czasowa powinna być przesunięta względem czasu UTC. Jeśli ta opcja jest ustawiona, data i godzina są wyświetlane w określonej strefie czasowej. Jeśli nie jest ustawiona, godzina jest wyświetlana w strefie czasowej użytkownika.

Parametry

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

Powrót

DateTimePicker – ten selektor do łączenia.

setTitle(title)

Ustawia tytuł wyświetlany nad polem wprowadzania.

Parametry

NazwaTypOpis
titleStringTytuł pola do wprowadzania danych.

Powrót

DateTimePicker – ten selektor do łączenia.

setValueInMsSinceEpoch(valueMsEpoch)

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

Parametry

NazwaTypOpis
valueMsEpochNumberWartość domyślna umieszczona w polu wejściowym jako liczba w milisekundach od początku epoki. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy.

Powrót

DateTimePicker – ten selektor do łączenia.

setValueInMsSinceEpoch(valueMsEpoch)

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

Parametry

NazwaTypOpis
valueMsEpochStringWartość domyślna umieszczona w polu wejściowym jako ciąg znaków w milisekundach od początku epoki. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy.

Powrót

DateTimePicker – ten selektor do łączenia.