Class DateItem

DateItem (Date)

Élément de question qui permet d'indiquer une date. Vous pouvez accéder aux éléments ou les créer depuis un Form. Lorsqu'ils sont utilisés dans un questionnaire, ces éléments sont notés.

// Open a form by ID and add a new date item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateItem();
item.setTitle('When were you born?');

Méthodes

MéthodeType renvoyéBrève description
createResponse(response)ItemResponseCrée un ItemResponse pour cet élément de date.
duplicate()DateItemCrée une copie de cet élément et l'ajoute à la fin du formulaire.
getGeneralFeedback()QuizFeedbackAffiche les commentaires que voient les personnes interrogées lorsqu'elles répondent à une question notable.
getHelpText()StringRécupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
getId()IntegerRécupère l'identifiant unique de l'article.
getIndex()IntegerRécupère l'index de l'élément parmi tous les éléments du formulaire.
getPoints()IntegerAffiche le barème de notation d'un élément.
getTitle()StringRécupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem).
getType()ItemTypeRécupère le type de l'élément, représenté par ItemType.
includesYear()BooleanDétermine si l'élément de date inclut une option d'année.
isRequired()BooleanDétermine si la personne interrogée doit répondre à la question.
setGeneralFeedback(feedback)DateItemDéfinit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (par exemple, en cas de questions nécessitant une notation manuelle).
setHelpText(text)DateItemDéfinit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).
setIncludesYear(enableYear)DateItemDétermine si l'élément de date inclut un paramètre d'année.
setPoints(points)DateItemDéfinit le nombre de points qu'un élément notable vaut.
setRequired(enabled)DateItemCe paramètre détermine si la personne interrogée doit répondre à la question.
setTitle(title)DateItemDéfinit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem).

Documentation détaillée

createResponse(response)

Crée un ItemResponse pour cet élément de date. Les champs de type "time" de l'objet Date sont ignorés. Par défaut, seuls les champs "year", "month" et "day" sont utilisés. Si setIncludesYear(enabled) est défini sur false, l'année est également ignorée.

Paramètres

NomTypeDescription
responseDateUn objet Date qui représente un mois, un jour et éventuellement une année

Aller-retour

ItemResponse : réponse de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

duplicate()

Crée une copie de cet élément et l'ajoute à la fin du formulaire.

Aller-retour

DateItem : doublon de DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

getGeneralFeedback()

Affiche les commentaires que voient les personnes interrogées lorsqu'elles répondent à une question notable.

Aller-retour

QuizFeedback : commentaires, le cas échéant.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

getHelpText()

Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).

Aller-retour

String : texte d'aide ou description

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

getId()

Récupère l'identifiant unique de l'article.

Aller-retour

Integer : ID de l'article

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

getIndex()

Récupère l'index de l'élément parmi tous les éléments du formulaire.

Aller-retour

Integer : index de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

getPoints()

Affiche le barème de notation d'un élément.

Aller-retour

Integer : nombre de points gagnés par une question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

getTitle()

Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem).

Aller-retour

String : titre ou texte de l'en-tête de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

getType()

Récupère le type de l'élément, représenté par ItemType.

Aller-retour

ItemType : type de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

includesYear()

Détermine si l'élément de date inclut une option d'année.

Aller-retour

Boolean : true si la date inclut un paramètre d'année. false dans le cas contraire.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

isRequired()

Détermine si la personne interrogée doit répondre à la question.

Aller-retour

Boolean : indique si la personne interrogée doit répondre à la question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

setGeneralFeedback(feedback)

Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question notable qui n'a pas de réponse correcte ou incorrecte (par exemple, en cas de questions nécessitant une notation manuelle).

Paramètres

NomTypeDescription
feedbackQuizFeedbackles nouveaux commentaires

Aller-retour

DateItem : cet élément DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

setHelpText(text)

Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems, PageBreakItems et SectionHeaderItems).

Paramètres

NomTypeDescription
textStringle nouveau texte d'aide

Aller-retour

DateItem : cet élément DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

setIncludesYear(enableYear)

Détermine si l'élément de date inclut un paramètre d'année. La valeur par défaut pour les nouveaux éléments de date est true.

Paramètres

NomTypeDescription
enableYearBooleantrue si la date inclut un paramètre d'année ; false dans le cas contraire

Aller-retour

DateItem : cet élément DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :

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

setPoints(points)

Définit le nombre de points qu'un élément notable vaut. La valeur par défaut pour les nouveaux éléments est 0.

Paramètres

NomTypeDescription
pointsIntegerle nombre de points d'une question

Aller-retour

DateItem : cet élément DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

setRequired(enabled)

Ce paramètre détermine si la personne interrogée doit répondre à la question.

Paramètres

NomTypeDescription
enabledBooleansi la personne interrogée doit répondre à la question

Aller-retour

DateItem : élément actuel (pour les chaînages)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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

setTitle(title)

Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem).

Paramètres

NomTypeDescription
titleStringle nouveau titre ou texte de l'en-tête

Aller-retour

DateItem : cet élément DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:

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