Selektor daty i godziny

Widżet DateTimePicker umożliwia użytkownikom wpisywanie daty, godziny lub daty i godziny.

Użytkownicy mogą wprowadzać tekst lub wybierać daty i godziny za pomocą selektora. Jeśli użytkownicy wpiszą nieprawidłową datę lub godzinę, selektor wyświetli komunikat o błędzie informujący o tym, że dane są prawidłowe.

Aplikacje do obsługi czatu otrzymują i przetwarzają wartość dat i godzin wpisanych przez użytkownika podczas zdarzeń w formularzu. Szczegółowe informacje o korzystaniu z danych wejściowych formularza znajdziesz w artykule Odbieranie danych formularza.

Przykład

Ten obraz przedstawia kartę zawierającą widżet DateTimePicker:

Karta z tekstem karty Google Chat z widżetem akapitu.
Ilustracja 1. Wiadomość w Google Chat z kartą przedstawiającą 3 widżety DateTimePicker: jeden do wyboru daty, godziny, a drugi tylko do daty.

Oto kod JSON karty:

JSON

{
  "cardsV2": [
    {
      "cardId": "exampleCard",
      "card": {
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "A datetime picker widget with both date and time:"
                }
              },
              {
                "divider": {}
              },
              {
                "dateTimePicker": {
                  "name": "date_time_picker_date_and_time",
                  "label": "meeting",
                  "type": "DATE_AND_TIME",
                }
              },
              {
                "textParagraph": {
                  "text": "A datetime picker widget with just date:"
                }
              },
              {
                "divider": {}
              },
              {
                "dateTimePicker": {
                  "name": "date_time_picker_date_and_time",
                  "label": "Choose a date",
                  "type": "DATE_ONLY",
                }
              },
              {
                "textParagraph": {
                  "text": "A datetime picker widget with just time:"
                }
              },
              {
                "divider": {}
              },
              {
                "dateTimePicker": {
                  "name": "date_time_picker_date_and_time",
                  "label": "Select a time",
                  "type": "TIME_ONLY",
                }
              },
            ]
          }
        ]
      }
    }
  ]
}

Reprezentacja i pola JSON

Zapis JSON
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  }
}
Pola
name

string

Nazwa, za pomocą której określony jest element DateTimePicker w zdarzeniu danych wejściowych w formularzu.

Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza.

label

string

Tekst zachęcający użytkowników do wpisania daty, godziny lub daty i godziny. Jeśli na przykład użytkownicy planują spotkanie, użyj etykiety takiej jak Appointment date lub Appointment date and time.

type

enum (DateTimePickerType)

Określa, czy widżet obsługuje wprowadzanie daty, godziny lub daty i godziny.

valueMsEpoch

string (int64 format)

Wartość domyślna wyświetlana w widżecie w milisekundach od czasu uniksowego.

Określ wartość w zależności od typu selektora (DateTimePickerType):

  • DATE_AND_TIME: data i godzina w kalendarzu w strefie czasowej UTC. Na przykład aby podać datę 1 stycznia 2023 r., godz. 12:00 UTC, użyj 1672574400000.
  • DATE_ONLY: data w kalendarzu o godzinie 00:00:00 czasu UTC. Na przykład do 1 stycznia 2023 r. użyj wartości 1672531200000.
  • TIME_ONLY: czas w strefie czasowej UTC. Na przykład, aby uwzględnić godzinę 12:00, wpisz 43200000 (lub 12 * 60 * 60 * 1000).
timezoneOffsetDate

integer

Liczba określająca przesunięcie czasu względem strefy czasowej UTC w minutach. Jeśli zasada jest ustawiona, wartość valueMsEpoch jest wyświetlana w określonej strefie czasowej. Jeśli zasada jest nieskonfigurowana, wartością domyślną jest ustawienie strefy czasowej użytkownika.

onChangeAction

object (Action)

Wywoływane, gdy użytkownik kliknie Zapisz lub Wyczyść w interfejsie DateTimePicker.

Typ daty i godziny

Wartości w polu enum
DATE_AND_TIME Użytkownicy wpisują datę i godzinę.
DATE_ONLY Użytkownicy wpisują datę.
TIME_ONLY Użytkownicy wpisują godzinę.

Czynność

Działanie opisujące zachowanie podczas przesyłania formularza. Możesz na przykład wywołać skrypt Apps Script, aby obsłużyć formularz. Jeśli działanie zostanie aktywowane, wartości formularza zostaną przesłane na serwer.

Zapis JSON
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
Pola
function

string

Funkcja niestandardowa, która ma być wywoływana po kliknięciu lub aktywowaniu elementu zawierającego.

Więcej informacji znajdziesz w artykule Tworzenie interaktywnych kart.

parameters[]

object (ActionParameter)

Lista parametrów działania.

loadIndicator

enum (LoadIndicator)

Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania.

persistValues

boolean

Wskazuje, czy po formularzu działanie formularza pozostaje aktywne. Wartością domyślną jest false.

Jeśli pole true zawiera wartości, po wypełnieniu pola działanie pozostaje aktywne. Aby pozwolić użytkownikowi na wprowadzanie zmian podczas przetwarzania działania, ustaw LoadIndicator na NONE. W przypadku kart kart w aplikacjach Google Chat musisz też ustawić wartość ResponseType dla działania na UPDATE_MESSAGE i użyć tej samej wartości cardId z karty, która zawiera działanie.

Jeśli false, wartości formularza zostaną wyczyszczone po wywołaniu działania. Aby uniemożliwić użytkownikowi wprowadzanie zmian podczas przetwarzania działania, ustaw wartość LoadIndicator na SPINNER.

interaction

enum (Interaction)

Opcjonalnie. Wymagane przy otwieraniu okna.

Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.

Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając action, np. otwierając link lub uruchamiając funkcję.

Jeśli określisz interaction, aplikacja może reagować w specjalny sposób. Jeśli na przykład ustawisz interaction na wartość OPEN_DIALOG, aplikacja będzie mogła otwierać okno. Jeśli podasz wartość, wskaźnik ładowania się nie wyświetli.

Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

Parametr działania

Lista parametrów ciągu znaków, które mają zostać podane po wywołaniu metody działania. Możesz np. wybrać 3 przyciski drzemki: drzemka teraz, drzemka na dzień lub drzemkę w przyszłym tygodniu. Można użyć właściwości action method = snooze(), przekazując typ drzemki i czas drzemki na liście parametrów ciągu znaków.

Więcej informacji: CommonEventObject.

Zapis JSON
{
  "key": string,
  "value": string
}
Pola
key

string

Nazwa parametru skryptu działania.

value

string

Wartość parametru.

Wskaźnik obciążenia

Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania.

Wartości w polu enum
SPINNER Wyświetla wskaźnik postępu wczytywania treści.
NONE Nic nie jest wyświetlane.

Interakcja

Opcjonalnie. Wymagane przy otwieraniu okna.

Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.

Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając action, np. otwierając link lub uruchamiając funkcję.

Jeśli określisz interaction, aplikacja może reagować w specjalny sposób. Jeśli na przykład ustawisz interaction na wartość OPEN_DIALOG, aplikacja będzie mogła otwierać okno.

Jeśli podasz wartość, wskaźnik ładowania się nie wyświetli.

Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.

Wartości w polu enum
INTERACTION_UNSPECIFIED Wartość domyślna. action działa normalnie.
OPEN_DIALOG

Otwiera okno – interfejs użytkownika w postaci okna, który umożliwia aplikacjom Google Chat interakcję z użytkownikami.

Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcie przycisku na karcie.

Nieobsługiwane przez dodatki do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.