Class DateTimePicker

Selettoreoradata

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

Supporta la convalida dell'invio dei 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
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 flusso Google Workspace, le variabili di input accettano output di data e ora da altri passaggi del flusso.
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.

Documentazione dettagliata

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 flusso Google Workspace, le variabili di input accettano output di data e ora da altri passaggi del flusso. Ad esempio, ricevi l'ora in cui è stato inviato un messaggio Gmail o la data in cui è pianificato un evento nel calendario.

Disponibile solo tramite il programma Gemini Alpha per i componenti aggiuntivi Google Workspace che estendono i flussi di Google Workspace.

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.


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.