Class DateTimePicker

DateTimePicker

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

Supporta la convalida dell'invio del modulo. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) è impostato su true o 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
setFieldName(fieldName)	DateTimePicker	Imposta il nome del campo che identifica questo selettore nell'oggetto evento generato quando avviene un'interazione con l'interfaccia utente.
setOnChangeAction(action)	DateTimePicker	Imposta un Action che viene eseguito dallo script ogni volta che l'input del selettore cambia.
setTimeZoneOffsetInMins(timeZoneOffsetMins)	DateTimePicker	Imposta il numero di minuti di differenza rispetto all'ora UTC per il fuso orario.
setTitle(title)	DateTimePicker	Imposta il titolo visualizzato sopra il campo di immissione.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	Imposta il valore precompilato da impostare nel campo di immissione.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	Imposta il valore precompilato da impostare nel campo di immissione.

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

DateTimePicker: 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

DateTimePicker: questo selettore, per l'accodamento.

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

Parametri

Nome	Tipo	Descrizione
timeZoneOffsetMins	Integer	Il numero di minuti di differenza tra il fuso orario e UTC.

Invio

DateTimePicker: 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

DateTimePicker: questo selettore, per l'accodamento.

---

setValueInMsSinceEpoch(valueMsEpoch)

Imposta il valore precompilato da impostare nel campo di immissione.

Parametri

Nome	Tipo	Descrizione
valueMsEpoch	Number	Il valore predefinito inserito nell'input come numero, in millisecondi dall'epoca. Viene sempre rappresentato come stringa nei parametri di callback del modulo.

Invio

DateTimePicker: questo selettore, per l'accodamento.

---

setValueInMsSinceEpoch(valueMsEpoch)

Imposta il valore precompilato da impostare nel campo di immissione.

Parametri

Nome	Tipo	Descrizione
valueMsEpoch	String	Il valore predefinito inserito nell'input come stringa, in millisecondi dall'epoca. Viene sempre rappresentato come stringa nei parametri di callback del modulo.

Invio

DateTimePicker: questo selettore, per l'accodamento.