Class DateTimePicker
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
DataCzasSelektor
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'),
);
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
| Nazwa | Typ | Opis |
fieldName | String | Nazwa 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
| Nazwa | Typ | Opis |
action | Action | Dział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
| Nazwa | Typ | Opis |
timeZoneOffsetMins | Integer | Liczba 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
| Nazwa | Typ | Opis |
title | String | Tytuł pola danych. |
Powrót
DateTimePicker – ten selektor do łańcuchowania.
setValueInMsSinceEpoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość w polu tekstowym.
Parametry
| Nazwa | Typ | Opis |
valueMsEpoch | 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
DateTimePicker – ten selektor do łańcuchowania.
setValueInMsSinceEpoch(valueMsEpoch)
Ustawia wstępnie wypełnioną wartość w polu tekstowym.
Parametry
| Nazwa | Typ | Opis |
valueMsEpoch | 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
DateTimePicker – ten selektor do łańcuchowania.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eDateTimePicker is an input field that allows users to input both a date and a time within Google Workspace Add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eIt provides functionalities to set a title, a default value, and a specific time zone for the date and time selection.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can set a field name for identifying the picker in events, and trigger custom actions when the input changes using \u003ccode\u003esetOnChangeAction()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe prefilled value can be set using milliseconds since the epoch, represented as either a number or a string.\u003c/p\u003e\n"]]],[],null,["# Class DateTimePicker\n\nDateTimePicker\n\nAn input field that allows users to input a date and time.\n\nSupports form submission validation. When [Action.setAllWidgetsAreRequired(allWidgetsAreRequired)](/apps-script/reference/card-service/action#setAllWidgetsAreRequired(Boolean)) is set to\n`true` or this widget is specified through [Action.addRequiredWidget(requiredWidget)](/apps-script/reference/card-service/action#addRequiredWidget(String)), the submission\naction is blocked unless a value is selected.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst dateTimePicker =\n CardService.newDateTimePicker()\n .setTitle('Enter the date and time.')\n .setFieldName('date_time_field')\n // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or\n // string is acceptable.\n .setValueInMsSinceEpoch(1514775600)\n // EDT time is 5 hours behind UTC.\n .setTimeZoneOffsetInMins(-5 * 60)\n .setOnChangeAction(\n CardService.newAction().setFunctionName('handleDateTimeChange'),\n );\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|----------------------------------------------------------------------------------|---------------------|--------------------------------------------------------------------------------------------------------------------------|\n| [setFieldName(fieldName)](#setFieldName(String)) | [DateTimePicker](#) | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |\n| [setOnChangeAction(action)](#setOnChangeAction(Action)) | [DateTimePicker](#) | Sets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes. |\n| [setTimeZoneOffsetInMins(timeZoneOffsetMins)](#setTimeZoneOffsetInMins(Integer)) | [DateTimePicker](#) | Sets the number of minutes that the time zone should be offset from UTC. |\n| [setTitle(title)](#setTitle(String)) | [DateTimePicker](#) | Sets the title displayed above the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(Number)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n| [setValueInMsSinceEpoch(valueMsEpoch)](#setValueInMsSinceEpoch(String)) | [DateTimePicker](#) | Sets the prefilled value to be set in the input field. |\n\nDetailed documentation\n----------------------\n\n### `set``Field``Name(fieldName)`\n\nSets the field name that identifies this picker in the event object that is generated when\nthere is a UI interaction. The field name is visible to the user. Required; the specified field\nname must be unique.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|----------|-----------------------------------|\n| `field``Name` | `String` | The name to assign to this input. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``On``Change``Action(action)`\n\nSets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------|---------------------|\n| `action` | [Action](/apps-script/reference/card-service/action) | The action to take. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Time``Zone``Offset``In``Mins(timeZoneOffsetMins)`\n\nSets the number of minutes that the time zone should be offset from UTC. If set, the date and\ntime is displayed in the specified time zone. If not set, the time is displayed in the user's\ntime zone.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------------------|-----------|--------------------------------------------------------------|\n| `time``Zone``Offset``Mins` | `Integer` | The number of minutes that the time zone is offset from UTC. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the title displayed above the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|------------------------|\n| `title` | `String` | The input field title. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `Number` | The default value placed in the input as a number, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Value``In``Ms``Since``Epoch(valueMsEpoch)`\n\nSets the prefilled value to be set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value``Ms``Epoch` | `String` | The default value placed in the input as a string, in milliseconds since the epoch. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[DateTimePicker](#) --- This picker, for chaining."]]
