Diese Seite wurde von der Cloud Translation API übersetzt.

Class DateTimeItem

Ein Frageelement, mit dem Teilnehmer ein Datum und eine Uhrzeit angeben können. Elemente können aufgerufen oder erstellt aus einem Form. Diese Elemente werden in einem Quiz benotet.

// 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?');

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`createResponse(response)`	`ItemResponse`	Erstellt eine neue `ItemResponse` für dieses Datum-Uhrzeit-Element.
`duplicate()`	`DateTimeItem`	Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
`getGeneralFeedback()`	`QuizFeedback`	Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten.
`getHelpText()`	`String`	Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet.
`getId()`	`Integer`	Ruft die eindeutige Kennzeichnung des Artikels ab.
`getIndex()`	`Integer`	Ruft den Index des Elements unter allen Elementen im Formular ab.
`getPoints()`	`Integer`	Gibt die Punktzahl eines benoteten Elements zurück
`getTitle()`	`String`	Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von `SectionHeaderItem`.
`getType()`	`ItemType`	Ruft den Typ des Elements ab, dargestellt als `ItemType`.
`includesYear()`	`Boolean`	Legt fest, ob das Datumselement eine Jahresoption enthält.
`isRequired()`	`Boolean`	Bestimmt, ob der Teilnehmer die Frage beantworten muss.
`setGeneralFeedback(feedback)`	`DateTimeItem`	Legt fest, dass das Feedback den Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat.
`setHelpText(text)`	`DateTimeItem`	Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie `ImageItems`, `PageBreakItems` und `SectionHeaderItems` bezeichnet).
`setIncludesYear(enableYear)`	`DateTimeItem`	Legt fest, ob das Datumselement eine Jahreseinstellung enthält.
`setPoints(points)`	`DateTimeItem`	Legt die Anzahl der Punkte fest, die ein benotetes Element wert ist.
`setRequired(enabled)`	`DateTimeItem`	Legt fest, ob der Befragte die Frage beantworten muss.
`setTitle(title)`	`DateTimeItem`	Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines `SectionHeaderItem`).

Detaillierte Dokumentation

`createResponse(response)`

Erstellt eine neue ItemResponse für dieses Datum-Uhrzeit-Element. Das Feld „seconds“ des Objekts Date wird ignoriert. Standardmäßig werden die Felder Jahr, Monat, Tag, Stunde und Minute verwendet. Wenn setIncludesYear(enabled) ist auf false gesetzt, das Jahr ist werden ebenfalls ignoriert.

Parameter

Name	Typ	Beschreibung
`response`	`Date`	Ein `Date`-Objekt, das einen Monat, einen Tag, eine Stunde, eine Minute und möglicherweise Jahr

Rückflug

ItemResponse – die Elementantwort

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`duplicate()`

Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.

Rückflug

DateTimeItem – ein Duplikat von DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getGeneralFeedback()`

Gibt das Feedback zurück, das die Befragten sehen, wenn sie auf eine benotete Frage antworten.

Rückflug

QuizFeedback: das Feedback, falls vorhanden.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getHelpText()`

Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.

Rückflug

String: Hilfe- oder Beschreibungstext des Elements

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getId()`

Ruft die eindeutige Kennzeichnung des Artikels ab.

Rückflug

Integer: die ID des Artikels

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getIndex()`

Ruft den Index des Elements unter allen Elementen im Formular ab.

Rückflug

Integer – Index des Elements

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getPoints()`

Gibt die Punktzahl eines benoteten Elements zurück

Rückflug

Integer: die Anzahl der Punkte, die eine Frage wert ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getTitle()`

Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem.

Rückflug

String: Titel oder Text der Überschrift des Elements

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`getType()`

Ruft den Typ des Elements ab, dargestellt als ItemType.

Rückflug

ItemType – Typ des Elements

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`includesYear()`

Legt fest, ob das Datumselement eine Jahresoption enthält.

Rückflug

Boolean: true, wenn das Datum eine Jahreseinstellung enthält. false wenn nicht

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`isRequired()`

Bestimmt, ob der Teilnehmer die Frage beantworten muss.

Rückflug

Boolean – ob der Teilnehmer die Frage beantworten muss

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setGeneralFeedback(feedback)`

Legt fest, dass das Feedback den Befragten angezeigt wird, wenn diese auf eine benotete Frage antworten, die keine richtige oder falsche Antwort (z. B. Fragen, die eine manuelle Benotung erfordern) hat.

Parameter

Name	Typ	Beschreibung
`feedback`	`QuizFeedback`	das neue Feedback

Rückflug

DateTimeItem – diese DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setHelpText(text)`

Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

Name	Typ	Beschreibung
`text`	`String`	den neuen Hilfetext

Rückflug

DateTimeItem – diese DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setIncludesYear(enableYear)`

Legt fest, ob das Datumselement eine Jahreseinstellung enthält. Der Standardwert für neue Datumselemente ist true.

Parameter

Name	Typ	Beschreibung
`enableYear`	`Boolean`	`true`, wenn das Datum eine Jahreseinstellung enthält; `false` wenn nicht

Rückflug

DateTimeItem – diese DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setPoints(points)`

Legt die Anzahl der Punkte fest, die ein benotetes Element wert ist. Der Standardwert für neue Elemente ist 0.

Parameter

Name	Typ	Beschreibung
`points`	`Integer`	die Anzahl der Punkte, die eine Frage wert ist

Rückflug

DateTimeItem – diese DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setRequired(enabled)`

Legt fest, ob der Befragte die Frage beantworten muss.

Parameter

Name	Typ	Beschreibung
`enabled`	`Boolean`	ob der Befragte die Frage beantworten muss.

Rückflug

DateTimeItem – das aktuelle Element (für Verkettung)

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

`setTitle(title)`

Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem).

Parameter

Name	Typ	Beschreibung
`title`	`String`	den neuen Titel oder Überschriftentext

Rückflug

DateTimeItem – diese DateTimeItem, für Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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