Pole do wprowadzania danych, które umożliwia użytkownikom wpisanie daty i godziny.
Obsługuje weryfikację przesłania formularza. Gdy parametr Action.setAllWidgetsAreRequired(allWidgetsAreRequired) ma wartość true lub gdy ten widżet jest określony za pomocą parametru Action.addRequiredWidget(requiredWidget), przesłanie jest blokowane, chyba że zostanie wybrana wartość.
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
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
set | Date | Ustawia nazwę pola, która identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem użytkownika. |
set | Date | Ustawia funkcję Action, którą skrypt wykonuje, gdy zmienia się dane wejściowe selektora. |
set | Date | Określa liczbę minut, o jaką strefa czasowa ma się przesunąć względem czasu UTC. |
set | Date | Ustawia tytuł wyświetlany nad polem wprowadzania danych. |
set | Date | Ustawia wstępnie wypełnioną wartość w polu tekstowym. |
set | Date | Ustawia wstępnie wypełnioną wartość w polu tekstowym. |
Szczegółowa dokumentacja
set Field Name(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
| Nazwa | Typ | Opis |
|---|---|---|
field | String | Nazwa do przypisania temu wejściu. |
Powrót
Date – ten selektor do łańcuchowania.
set On Change Action(action)
Ustawia funkcję Action, którą skrypt wykonuje, gdy zmienia się dane wejściowe selektora.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
action | Action | Działanie do wykonania. |
Powrót
Date – ten selektor do łańcuchowania.
set Time Zone Offset In Mins(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
| Nazwa | Typ | Opis |
|---|---|---|
time | Integer | Liczba minut, o którą strefa czasowa jest przesunięta względem UTC. |
Powrót
Date – ten selektor do łańcuchowania.
set Title(title)
Ustawia tytuł wyświetlany nad polem wprowadzania danych.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
title | String | Tytuł pola danych. |
Powrót
Date – ten selektor do łańcuchowania.
set Value In Ms Since Epoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość w polu tekstowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | Number | Domyślna wartość 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
Date – ten selektor do łańcuchowania.
set Value In Ms Since Epoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość w polu tekstowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | String | Wartość 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
Date – ten selektor do łańcuchowania.