Un campo di immissione che consente agli utenti di inserire una data e un'ora.
Supporta la convalida dell'invio del modulo. Se Action.setAllWidgetsAreRequired(allWidgetsAreRequired) è impostato su true o se questo widget è specificato tramite Action.addRequiredWidget(requiredWidget), l'azione di invio viene bloccata a meno che non venga selezionato un valore.
Disponibile per i componenti aggiuntivi di Google Workspace e le app 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'), );
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
add | Widget | Aggiunge l'azione evento che può essere eseguita sul widget. |
set | Date | Imposta il nome del campo che identifica questo selettore nell'oggetto evento generato quando si verifica un'interazione dell'interfaccia utente. |
set | Date | In un agente Google Workspace Studio, consente alle variabili di input di accettare output di data e ora da altri passaggi dell'agente. |
set | Widget | Imposta l'ID univoco assegnato utilizzato per identificare il widget da modificare. |
set | Date | Imposta un' Action che lo script esegue ogni volta che l'input del selettore cambia. |
set | Date | Imposta il numero di minuti di cui il fuso orario deve essere spostato rispetto all'UTC. |
set | Date | Imposta il titolo visualizzato sopra il campo di immissione. |
set | Date | Imposta il valore precompilato da impostare nel campo di immissione. |
set | Date | Imposta il valore precompilato da impostare nel campo di immissione. |
set | Widget | Imposta la visibilità del widget. |
Documentazione dettagliata
addEventAction(eventAction)
Aggiunge l'azione evento che può essere eseguita sul widget.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
event | Event | Il Event da aggiungere. |
Indietro
Widget : l'oggetto, per il concatenamento.
setFieldName(fieldName)
Imposta il nome del campo che identifica questo selettore nell'oggetto evento generato quando si verifica un'interazione dell'interfaccia utente. Il nome del campo è visibile all'utente. Obbligatorio; il nome del campo specificato deve essere univoco.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
field | String | Il nome da assegnare a questo input. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setHostAppDataSource(hostAppDataSource)
In un agente Google Workspace Studio, consente alle variabili di input di accettare output di data e ora da altri passaggi dell'agente. Ad esempio, ricevi l'ora in cui è stato inviato un messaggio Gmail o la data in cui è programmato un evento di Calendar.
Disponibile solo per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio.
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);
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
host | Host | L'origine dati. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setId(id)
Imposta l'ID univoco assegnato utilizzato per identificare il widget da modificare. La mutazione dei widget è supportata solo nei componenti aggiuntivi.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
id | String | L'ID del widget, con un limite di 64 caratteri e nel formato `[a-zA-Z0-9-]+`. |
Indietro
Widget : questo oggetto, per il concatenamento.
setOnChangeAction(action)
Imposta un' Action che lo script esegue ogni volta che l'input del selettore cambia.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
action | Action | L'azione da intraprendere. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setTimeZoneOffsetInMins(timeZoneOffsetMins)
Imposta il numero di minuti di cui il fuso orario deve essere spostato rispetto all'UTC. Se impostata, la data e l'ora vengono visualizzate nel fuso orario specificato. Se non è impostata, l'ora viene visualizzata nel fuso orario dell'utente.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
time | Integer | Il numero di minuti di cui il fuso orario è spostato rispetto all'UTC. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setTitle(title)
Imposta il titolo visualizzato sopra il campo di immissione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
title | String | Il titolo del campo di immissione. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setValueInMsSinceEpoch(valueMsEpoch)
Imposta il valore precompilato da impostare nel campo di immissione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
value | Number | Il valore predefinito inserito nell'input come numero, in millisecondi da l'epoca. Viene sempre rappresentato come stringa nei parametri di callback del modulo. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setValueInMsSinceEpoch(valueMsEpoch)
Imposta il valore precompilato da impostare nel campo di immissione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
value | String | Il valore predefinito inserito nell'input come stringa, in millisecondi da l'epoca. Viene sempre rappresentato come stringa nei parametri di callback del modulo. |
Indietro
DateTimePicker : questo selettore, per il concatenamento.
setVisibility(visibility)
Imposta la visibilità del widget. Il valore predefinito è `VISIBLE`.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
visibility | Visibility | La Visibility del widget. |
Indietro
Widget : l'oggetto, per il concatenamento.