Class DateTimeItem

DateTimeItem

Element pytania, który umożliwia respondentowi podanie daty i godziny. Dostęp do elementów można uzyskać lub tworzyć je z poziomu Form. Jeśli są używane w teście, podlegają ocenie.

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

Metody

Metoda	Zwracany typ	Krótki opis
createResponse(response)	ItemResponse	Tworzy nowy ItemResponse dla tego elementu daty i godziny.
duplicate()	DateTimeItem	Tworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()	QuizFeedback|null	Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.
getHelpText()	String	Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()	Integer	Pobiera unikalny identyfikator elementu.
getIndex()	Integer	Pobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()	Integer	Zwraca liczbę punktów elementu podlegającego ocenie.
getTitle()	String	Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
getType()	ItemType	Pobiera typ elementu reprezentowany jako ItemType.
includesYear()	Boolean	Określa, czy element daty zawiera opcję roku.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setGeneralFeedback(feedback)	DateTimeItem	Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
setHelpText(text)	DateTimeItem	Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setIncludesYear(enableYear)	DateTimeItem	Określa, czy element daty zawiera ustawienie roku.
setPoints(points)	DateTimeItem	Ustawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)	DateTimeItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	DateTimeItem	Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Szczegółowa dokumentacja

createResponse(response)

Tworzy nowy ItemResponse dla tego elementu daty i godziny. Pole sekund obiektu Date jest ignorowane. Domyślnie używane są pola roku, miesiąca, dnia, godziny i minuty. Jeśli wartość setIncludesYear(enabled) to false, rok jest również ignorowany.

Parametry

Nazwa	Typ	Opis
response	Date	obiekt Date, który reprezentuje miesiąc, dzień, godzinę, minutę i ewentualnie rok;

Powrót

ItemResponse – odpowiedź dotycząca elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

duplicate()

Tworzy kopię tego elementu i dołącza ją na końcu formularza.

Powrót

DateTimeItem – duplikat tego DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getGeneralFeedback()

Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie.

Powrót

QuizFeedback|null – opinia (jeśli występuje).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getHelpText()

Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getId()

Pobiera unikalny identyfikator elementu.

Powrót

Integer – identyfikator produktu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getIndex()

Pobiera indeks elementu spośród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getPoints()

Zwraca liczbę punktów elementu podlegającego ocenie.

Powrót

Integer – liczba punktów za pytanie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Powrót

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

includesYear()

Określa, czy element daty zawiera opcję roku.

Powrót

Boolean – true jeśli data zawiera ustawienie roku; false jeśli nie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

isRequired()

Określa, czy respondent musi odpowiedzieć na pytanie.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setGeneralFeedback(feedback)

Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).

Parametry

Nazwa	Typ	Opis
feedback	QuizFeedback	nowa opinia.

Powrót

DateTimeItem – ten DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setHelpText(text)

Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

Nazwa	Typ	Opis
text	String	nowy tekst pomocy,

Powrót

DateTimeItem – ten DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setIncludesYear(enableYear)

Określa, czy element daty zawiera ustawienie roku. Domyślna wartość nowych elementów daty to true.

Parametry

Nazwa	Typ	Opis
enableYear	Boolean	true jeśli data zawiera ustawienie roku; false jeśli nie.

Powrót

DateTimeItem – ten DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setPoints(points)

Ustawia liczbę punktów, jaką jest warta oceniana pozycja. Wartość domyślna dla nowych elementów to 0.

Parametry

Nazwa	Typ	Opis
points	Integer	liczbę punktów, jaką jest warta pozycja pytania;

Powrót

DateTimeItem – ten DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setRequired(enabled)

Określa, czy respondent musi odpowiedzieć na pytanie.

Parametry

Nazwa	Typ	Opis
enabled	Boolean	czy respondent musi odpowiedzieć na pytanie;

Powrót

DateTimeItem – bieżący element (do łączenia w łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

setTitle(title)

Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

Nazwa	Typ	Opis
title	String	nowy tytuł lub tekst nagłówka;

Powrót

DateTimeItem – ten DateTimeItem do łączenia

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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