Class DateTimeItem

DataOraArticolo

Un elemento domanda che consente al rispondente di indicare una data e un'ora. È possibile accedere agli elementi o crearli da un Form. Se utilizzati in un quiz, questi elementi vengono valutati. 

// Open a form by ID and add a new date-time item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

Metodi

MetodoTipo restituitoBreve descrizione
createResponse(response)ItemResponseCrea un nuovo ItemResponse per questo elemento data e ora.
duplicate()DateTimeItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()QuizFeedback|nullRestituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecupera l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi del modulo.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getTitle()StringRecupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).
getType()ItemTypeRestituisce il tipo dell'elemento, rappresentato come ItemType.
includesYear()BooleanDetermina se l'elemento data include un'opzione per l'anno.
isRequired()BooleanDetermina se il rispondente deve rispondere alla domanda.
setGeneralFeedback(feedback)DateTimeItemImposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad esempio, le domande che richiedono una valutazione manuale).
setHelpText(text)DateTimeItemImposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemImposta se l'elemento data include un'impostazione dell'anno.
setPoints(points)DateTimeItemImposta il numero di punti che vale un elemento valutabile.
setRequired(enabled)DateTimeItemImposta se il rispondente deve rispondere alla domanda.
setTitle(title)DateTimeItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Documentazione dettagliata

createResponse(response)

Crea un nuovo ItemResponse per questo elemento data e ora. Il campo dei secondi dell'oggetto Date viene ignorato; per impostazione predefinita, vengono utilizzati i campi anno, mese, giorno, ora e minuti. Se setIncludesYear(enabled) è impostato su false, anche l'anno viene ignorato.

Parametri

NomeTipoDescrizione
responseDateun oggetto Date che rappresenta un mese, un giorno, un'ora, un minuto e, possibilmente, un anno

Indietro

ItemResponse: la risposta all'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

duplicate()

Crea una copia di questo elemento e la aggiunge alla fine del modulo.

Indietro

DateTimeItem: un duplicato di questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGeneralFeedback()

Restituisce il feedback mostrato ai rispondenti quando rispondono a una domanda valutabile.

Indietro

QuizFeedback|null: il feedback, se presente.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

Recupera il testo della guida dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Indietro

String: il testo della guida o la descrizione dell'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

Recupera l'identificatore univoco dell'elemento.

Indietro

Integer: l'ID dell'articolo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

Restituisce l'indice dell'elemento tra tutti gli elementi del modulo.

Indietro

Integer: l'indice dell'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPoints()

Restituisce il valore in punti di un elemento valutabile.

Indietro

Integer: il numero di punti che vale una domanda.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

Recupera il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Indietro

String: il titolo o il testo dell'intestazione dell'elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

Restituisce il tipo dell'elemento, rappresentato come ItemType.

Indietro

ItemType: il tipo di elemento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

includesYear()

Determina se l'elemento data include un'opzione per l'anno.

Indietro

Boolean - true se la data include un'impostazione dell'anno; false in caso contrario

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isRequired()

Determina se il rispondente deve rispondere alla domanda.

Indietro

Boolean: indica se il rispondente deve rispondere alla domanda

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGeneralFeedback(feedback)

Imposta il feedback da mostrare ai rispondenti quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ad esempio, le domande che richiedono una valutazione manuale).

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Indietro

DateTimeItem: questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

Imposta il testo di assistenza dell'elemento (a volte chiamato testo della descrizione per gli elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Indietro

DateTimeItem: questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setIncludesYear(enableYear)

Imposta se l'elemento data include un'impostazione dell'anno. Il valore predefinito per i nuovi elementi di data è true.

Parametri

NomeTipoDescrizione
enableYearBooleantrue se la data include un'impostazione dell'anno; false in caso contrario

Indietro

DateTimeItem: questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setPoints(points)

Imposta il numero di punti che vale un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti che vale una domanda

Indietro

DateTimeItem: questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setRequired(enabled)

Imposta se il rispondente deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse il rispondente deve rispondere alla domanda

Indietro

DateTimeItem: l'elemento corrente (per il concatenamento)

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di un SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo testo del titolo o dell'intestazione

Indietro

DateTimeItem: questo DateTimeItem, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms