Class DateTimeItem

DateTimeItem

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

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

Metodi

MetodoTipo restituitoBreve descrizione
createResponse(response)ItemResponseCrea un nuovo ItemResponse per questo elemento con data e ora.
duplicate()DateTimeItemCrea una copia di questo elemento e la aggiunge alla fine del modulo.
getGeneralFeedback()QuizFeedbackRestituisce il feedback che viene mostrato agli intervistati quando rispondono a una domanda valutabile.
getHelpText()StringRecupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerConsente di acquisire l'identificatore univoco dell'elemento.
getIndex()IntegerRestituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
getPoints()IntegerRestituisce il valore in punti di un elemento valutabile.
getTitle()StringConsente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
getType()ItemTypeRestituisce il tipo di elemento, rappresentato come ItemType.
includesYear()BooleanDetermina se l'elemento della data include un'opzione per l'anno.
isRequired()BooleanStabilisce se l'intervistato deve rispondere alla domanda.
setGeneralFeedback(feedback)DateTimeItemImposta il feedback da mostrare agli intervistati quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ovvero domande che richiedono la valutazione manuale).
setHelpText(text)DateTimeItemImposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
setIncludesYear(enableYear)DateTimeItemConsente di impostare se l'elemento della data include un'impostazione relativa all'anno.
setPoints(points)DateTimeItemImposta il numero di punti per il valore di un elemento valutabile.
setRequired(enabled)DateTimeItemConsente di stabilire se l'intervistato deve rispondere alla domanda.
setTitle(title)DateTimeItemImposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).

Documentazione dettagliata

createResponse(response)

Crea un nuovo ItemResponse per questo elemento con 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

Ritorni

ItemResponse: la risposta 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

duplicate()

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

Ritorni

DateTimeItem: 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 che viene mostrato agli intervistati quando rispondono a una domanda valutabile.

Ritorni

QuizFeedback: feedback, se disponibile.

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 descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Ritorni

String: testo della guida o testo descrittivo 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()

Consente di acquisire l'identificatore univoco dell'elemento.

Ritorni

Integer: 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 nel modulo.

Ritorni

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.

Ritorni

Integer: il numero di punti di 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()

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

Ritorni

String: testo dell'intestazione o del titolo 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 di elemento, rappresentato come ItemType.

Ritorni

ItemType: 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 della data include un'opzione per l'anno.

Ritorni

Boolean: true se la data include un'impostazione relativa all'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()

Stabilisce se l'intervistato deve rispondere alla domanda.

Ritorni

Boolean: indica se la persona intervistata 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 agli intervistati quando rispondono a una domanda valutabile che non ha una risposta corretta o errata (ovvero domande che richiedono la valutazione manuale).

Parametri

NomeTipoDescrizione
feedbackQuizFeedbackil nuovo feedback

Ritorni

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 della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).

Parametri

NomeTipoDescrizione
textStringil nuovo testo della guida

Ritorni

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)

Consente di impostare se l'elemento della data include un'impostazione relativa all'anno. Il valore predefinito per i nuovi elementi di data è true.

Parametri

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

Ritorni

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 per il valore di un elemento valutabile. Il valore predefinito per i nuovi elementi è 0.

Parametri

NomeTipoDescrizione
pointsIntegeril numero di punti di un elemento di domanda

Ritorni

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)

Consente di stabilire se l'intervistato deve rispondere alla domanda.

Parametri

NomeTipoDescrizione
enabledBooleanse l'intervistato deve rispondere alla domanda

Ritorni

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 SectionHeaderItem).

Parametri

NomeTipoDescrizione
titleStringil nuovo testo dell'intestazione o del titolo

Ritorni

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