Class TimePicker
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Selettore ora
Un campo di immissione che consente agli utenti di inserire un'ora.
Disponibile per i componenti aggiuntivi di Google Workspace e le app Google Chat.
const dateTimePicker =
CardService.newTimePicker()
.setTitle('Enter the time.')
.setFieldName('time_field')
// Set default value as 3:30 AM.
.setHours(3)
.setMinutes(30)
.setOnChangeAction(
CardService.newAction().setFunctionName('handleDateTimeChange'),
);
Documentazione dettagliata
setFieldName(fieldName)
Imposta il nome del campo che identifica questo selettore nell'oggetto evento generato quando avviene un'interazione con l'interfaccia utente. Il nome del campo è visibile all'utente. Obbligatorio. Il nome del campo specificato deve essere univoco.
Parametri
Nome | Tipo | Descrizione |
fieldName | String | Il nome da assegnare a questo input. |
Invio
TimePicker
: questo selettore, per l'accodamento.
setHours(hours)
Imposta il valore precompilato delle ore da impostare nel campo di immissione.
Parametri
Nome | Tipo | Descrizione |
hours | Integer | Il valore predefinito dell'ora inserito nell'input, compreso tra 0 e 23. È sempre rappresentato come stringa nei parametri di callback del modulo. |
Invio
TimePicker
: questo selettore, per l'accodamento.
setMinutes(minutes)
Imposta il valore precompilato dei minuti da impostare nel campo di immissione.
Parametri
Nome | Tipo | Descrizione |
minutes | Integer | Il valore predefinito dei minuti inserito nell'input va da 0 a 59. È sempre rappresentato come stringa nei parametri di callback del modulo. |
Invio
TimePicker
: questo selettore, per l'accodamento.
setOnChangeAction(action)
Imposta un Action
che viene eseguito dallo script ogni volta che l'input del selettore cambia.
Parametri
Nome | Tipo | Descrizione |
action | Action | L'azione da eseguire. |
Invio
TimePicker
: questo selettore, per l'accodamento.
setTitle(title)
Imposta il titolo visualizzato sopra il campo di immissione.
Parametri
Nome | Tipo | Descrizione |
title | String | Il titolo del campo di immissione. |
Invio
TimePicker
: questo selettore, per l'accodamento.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 2025-07-26 UTC."],[[["\u003cp\u003eTimePicker is an input field that allows users to input a time, available for Google Workspace Add-ons and Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can prefill the TimePicker with a default time using \u003ccode\u003esetHours\u003c/code\u003e and \u003ccode\u003esetMinutes\u003c/code\u003e, and set a title using \u003ccode\u003esetTitle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetFieldName\u003c/code\u003e assigns a unique identifier for the picker, used in event objects for UI interactions.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003eOnChangeAction\u003c/code\u003e can be set to trigger a specific script function whenever the picker's input value is modified.\u003c/p\u003e\n"]]],[],null,["# Class TimePicker\n\nTimePicker\n\nAn input field that allows users to input a time.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\n```javascript\nconst dateTimePicker =\n CardService.newTimePicker()\n .setTitle('Enter the time.')\n .setFieldName('time_field')\n // Set default value as 3:30 AM.\n .setHours(3)\n .setMinutes(30)\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)) | [TimePicker](#) | Sets the field name that identifies this picker in the event object that is generated when there is a UI interaction. |\n| [setHours(hours)](#setHours(Integer)) | [TimePicker](#) | Sets the prefilled hours value to set in the input field. |\n| [setMinutes(minutes)](#setMinutes(Integer)) | [TimePicker](#) | Sets the prefilled minutes value to set in the input field. |\n| [setOnChangeAction(action)](#setOnChangeAction(Action)) | [TimePicker](#) | Sets an [Action](/apps-script/reference/card-service/action) that the script performs whenever the picker input changes. |\n| [setTitle(title)](#setTitle(String)) | [TimePicker](#) | Sets the title displayed above 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[TimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Hours(hours)`\n\nSets the prefilled hours value to set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|-----------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `hours` | `Integer` | The default hour value placed in the input, range from 0 to 23. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[TimePicker](#) --- This picker, for chaining.\n\n*** ** * ** ***\n\n### `set``Minutes(minutes)`\n\nSets the prefilled minutes value to set in the input field.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|-----------|------------------------------------------------------------------------------------------------------------------------------------------|\n| `minutes` | `Integer` | The default minutes value placed in the input, range from 0 to 59. It is always represented as a string in the form callback parameters. |\n\n#### Return\n\n\n[TimePicker](#) --- 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[TimePicker](#) --- 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[TimePicker](#) --- This picker, for chaining."]]