Cette page a été traduite par l'API Cloud Translation.

Class DateItem

Un élément de question qui permet à la personne interrogée d'indiquer une date. Les éléments sont accessibles ou 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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`	Renvoie les commentaires qui s'affichent pour les personnes interrogées lorsqu'elles répondent à une question pouvant être notée.
`getHelpText()`	`String`	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`).
`getId()`	`Integer`	Récupère l'identifiant unique de l'élément.
`getIndex()`	`Integer`	Récupère l'index de l'élément parmi tous les éléments du formulaire.
`getPoints()`	`Integer`	Affiche le barème de notation d'un élément pouvant être noté.
`getTitle()`	`String`	Récupère le titre de l'élément (parfois appelé "texte d'en-tête" dans le cas d'une `SectionHeaderItem`).
`getType()`	`ItemType`	Récupère le type d'élément, représenté par `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 les commentaires à présenter aux personnes interrogées lorsqu'elles répondent à une question pouvant être notée n'a pas de réponse correcte ou incorrecte (c'est-à-dire une question nécessitant une notation 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étermine si l'élément de date inclut un paramètre d'année.
`setPoints(points)`	`DateItem`	Définit le nombre de points qu'un élément pouvant être noté.
`setRequired(enabled)`	`DateItem`	Détermine 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'une propriété `SectionHeaderItem`).

Documentation détaillée

`createResponse(response)`

Crée un ItemResponse pour cet élément de date. Champs de temps de Date sont ignorés. par défaut, seuls les champs de l’année, du mois et du jour sont utilisés. Si setIncludesYear(enabled) est défini sur false, l'année est sont ignorées.

Paramètres

Nom	Type	Description
`response`	`Date`	Un objet `Date` qui représente 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 correspondant à 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.

Renvois

DateItem : doublon de DateItem, pour le chaînage

Autorisation

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

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

`getGeneralFeedback()`

Renvoie les commentaires qui s'affichent pour les personnes interrogées lorsqu'elles répondent à une question pouvant être notée.

Renvois

QuizFeedback : commentaires, le cas échéant.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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).

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'élément.

Renvois

Integer : ID de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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.

Renvois

Integer : index de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 pouvant être noté.

Renvois

Integer : nombre de points qu'une question vaut.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'une 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 correspondant à 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 d'élément, représenté par ItemType.

Renvois

ItemType : type de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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.

Renvois

Boolean : true si la date inclut le paramètre d'année false si ce n'est pas le cas

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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.

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 à présenter aux personnes interrogées lorsqu'elles répondent à une question pouvant être notée n'a pas de réponse correcte ou incorrecte (c'est-à-dire une question nécessitant une notation 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 correspondant à 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

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 correspondant à 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

Nom	Type	Description
`enableYear`	`Boolean`	`true` si la date inclut le paramètre d'année ; `false` si ce n'est pas le cas

Renvois

DateItem : DateItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 pouvant être noté. 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 correspondant à un ou plusieurs des champs d'application suivants:

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

`setRequired(enabled)`

Détermine 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'enchaînement)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'une propriété 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 correspondant à un ou plusieurs des champs d'application suivants:

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