Class DateTimePicker

Selettoreoradata

Un campo di input che consente agli utenti di inserire una data e un'ora.

Supporta la convalida dell'invio di moduli. 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

MetodoTipo restituitoBreve descrizione
addEventAction(eventAction)WidgetAggiunge l'azione evento che può essere eseguita sul widget.
setFieldName(fieldName)DateTimePickerImposta il nome del campo che identifica questo selettore nell'oggetto evento generato quando si verifica un'interazione con la UI.
setHostAppDataSource(hostAppDataSource)DateTimePickerIn un agente Google Workspace Studio, le variabili di input accettano output di data e ora da altri passaggi dell'agente.
setId(id)WidgetImposta l'ID univoco assegnato utilizzato per identificare il widget da modificare.
setOnChangeAction(action)DateTimePickerImposta un Action che lo script esegue ogni volta che cambia l'input del selettore.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerImposta il numero di minuti di differenza del fuso orario rispetto all'UTC.
setTitle(title)DateTimePickerImposta il titolo visualizzato sopra il campo di input.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerImposta il valore precompilato da impostare nel campo di input.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerImposta il valore precompilato da impostare nel campo di input.
setVisibility(visibility)WidgetImposta la visibilità del widget.

Documentazione dettagliata

addEventAction(eventAction)

Aggiunge l'azione evento che può essere eseguita sul widget.

Parametri

NomeTipoDescrizione
eventActionEventActionEventAction 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 con la UI. Il nome del campo è visibile all'utente. Obbligatorio; il nome del campo specificato deve essere univoco.

Parametri

NomeTipoDescrizione
fieldNameStringIl nome da assegnare a questo input.

Indietro

DateTimePicker: questo selettore, per il concatenamento.

setHostAppDataSource(hostAppDataSource)

In un agente Google Workspace Studio, le variabili di input accettano 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 è pianificato un evento nel calendario.

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

NomeTipoDescrizione
hostAppDataSourceHostAppDataSourceL'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

NomeTipoDescrizione
idStringL'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 cambia l'input del selettore.

Parametri

NomeTipoDescrizione
actionActionL'azione da intraprendere.

Indietro

DateTimePicker: questo selettore, per il concatenamento.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

Imposta il numero di minuti di differenza del fuso orario rispetto all'UTC. Se impostata, la data e l'ora vengono visualizzate nel fuso orario specificato. Se non è impostato, l'ora viene visualizzata nel fuso orario dell'utente.

Parametri

NomeTipoDescrizione
timeZoneOffsetMinsIntegerIl numero di minuti di differenza del fuso orario rispetto a UTC.

Indietro

DateTimePicker: questo selettore, per il concatenamento.

setTitle(title)

Imposta il titolo visualizzato sopra il campo di input.

Parametri

NomeTipoDescrizione
titleStringIl titolo del campo di input.

Indietro

DateTimePicker: questo selettore, per il concatenamento.

setValueInMsSinceEpoch(valueMsEpoch)

Imposta il valore precompilato da impostare nel campo di input.

Parametri

NomeTipoDescrizione
valueMsEpochNumberIl valore predefinito inserito nell'input come numero, in millisecondi dall'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 input.

Parametri

NomeTipoDescrizione
valueMsEpochStringIl valore predefinito inserito nell'input come stringa, in millisecondi dall'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

NomeTipoDescrizione
visibilityVisibilityIl Visibility del widget.

Indietro

Widget: l'oggetto, per il concatenamento.