Class DateItem

DateItem

Question permettant au répondant d'indiquer une date. Les éléments sont accessibles ou peuvent être créés à partir d'un Form. Lorsqu'ils sont utilisés dans un quiz, ces éléments sont notés.

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

Méthodes

Méthode	Type renvoyé	Brève description
createResponse(response)	ItemResponse	Crée un ItemResponse pour cet élément de date.
duplicate()	DateItem	Crée une copie de cet élément et l'ajoute à la fin du formulaire.
getGeneralFeedback()	QuizFeedback|null	Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée.
getHelpText()	String	Obtient 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()	Integer	Obtient l'identifiant unique de l'élément.
getIndex()	Integer	Obtient l'index de l'élément parmi tous les éléments du formulaire.
getPoints()	Integer	Renvoie la valeur en points d'un élément pouvant être noté.
getTitle()	String	Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un SectionHeaderItem).
getType()	ItemType	Obtient le type de l'élément, représenté sous la forme d'un ItemType.
includesYear()	Boolean	Détermine si l'élément de date inclut une option d'année.
isRequired()	Boolean	Détermine si la personne interrogée doit répondre à la question.
setGeneralFeedback(feedback)	DateItem	Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle).
setHelpText(text)	DateItem	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).
setIncludesYear(enableYear)	DateItem	Définit si l'élément de date inclut un paramètre d'année.
setPoints(points)	DateItem	Définit le nombre de points qu'un devoir peut rapporter.
setRequired(enabled)	DateItem	Indique si la personne interrogée doit répondre à la question.
setTitle(title)	DateItem	Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un SectionHeaderItem).

Documentation détaillée

createResponse(response)

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

Paramètres

Nom	Type	Description
response	Date	Objet Date représentant un mois, un jour et éventuellement une année

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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.

Renvois

DateItem : un double de ce DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getGeneralFeedback()

Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée.

Renvois

QuizFeedback|null : commentaire, le cas échéant.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getHelpText()

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

Renvois

String : texte d'aide ou description de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getId()

Obtient l'identifiant unique de l'élément.

Renvois

Integer : ID de l'article

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getIndex()

Obtient l'index de l'élément parmi tous les éléments du formulaire.

Renvois

Integer : index de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getPoints()

Renvoie la valeur en points d'un élément pouvant être noté.

Renvois

Integer : nombre de points attribués à une question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getTitle()

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

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getType()

Obtient le type de l'élément, représenté sous la forme d'un ItemType.

Renvois

ItemType : type de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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.

Renvois

Boolean : true si la date inclut un paramètre d'année, false sinon

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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.

Renvois

Boolean : indique si le répondant doit répondre à la question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setGeneralFeedback(feedback)

Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle).

Paramètres

Nom	Type	Description
feedback	QuizFeedback	les nouveaux commentaires

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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

Nom	Type	Description
text	String	le nouveau texte d'aide ;

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setIncludesYear(enableYear)

Définit 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

Nom	Type	Description
enableYear	Boolean	true si la date inclut un paramètre d'année ; false dans le cas contraire

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setPoints(points)

Définit le nombre de points qu'un devoir peut rapporter. La valeur par défaut pour les nouveaux éléments est 0.

Paramètres

Nom	Type	Description
points	Integer	le nombre de points qu'un élément de question vaut ;

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setRequired(enabled)

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

Paramètres

Nom	Type	Description
enabled	Boolean	si la personne interrogée doit répondre à la question.

Renvois

DateItem : élément actuel (pour l'association en chaîne)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 SectionHeaderItem).

Paramètres

Nom	Type	Description
title	String	le nouveau titre ou texte d'en-tête.

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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