Class DateTimeItem

DataHoraItem

Um item de pergunta que permite ao participante indicar uma data e hora. Os itens podem ser acessados ou criados em um Form. Quando usados em um teste, esses itens são avaliados.

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

Métodos

Método	Tipo de retorno	Breve descrição
createResponse(response)	ItemResponse	Cria um novo ItemResponse para este item de data e hora.
duplicate()	DateTimeItem	Cria uma cópia do item e a anexa ao final do formulário.
getGeneralFeedback()	QuizFeedback	Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota.
getHelpText()	String	Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).
getId()	Integer	Recebe o identificador exclusivo do item.
getIndex()	Integer	Consegue o índice do item entre todos os itens no formulário.
getPoints()	Integer	Retorna o valor em pontos de um item que pode ser avaliado.
getTitle()	String	Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
getType()	ItemType	Recebe o tipo do item, representado como um ItemType.
includesYear()	Boolean	Determina se o item de data inclui uma opção de ano.
isRequired()	Boolean	Determina se o participante precisa responder à pergunta.
setGeneralFeedback(feedback)	DateTimeItem	Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta que não tem uma resposta correta ou incorreta (ou seja, perguntas que exigem avaliação manual).
setHelpText(text)	DateTimeItem	Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).
setIncludesYear(enableYear)	DateTimeItem	Define se o item de data inclui uma configuração de ano.
setPoints(points)	DateTimeItem	Define o número de pontos de um item que pode ser avaliado.
setRequired(enabled)	DateTimeItem	Define se o respondente precisa responder à pergunta.
setTitle(title)	DateTimeItem	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Documentação detalhada

createResponse(response)

Cria um novo ItemResponse para este item de data e hora. O campo de segundos do objeto Date é ignorado. Por padrão, os campos de ano, mês, dia, hora e minuto são usados. Se setIncludesYear(enabled) for definido como false, o ano também será ignorado.

Parâmetros

Nome	Tipo	Descrição
response	Date	Um objeto Date que representa um mês, dia, hora, minuto e, possivelmente, ano

Retornar

ItemResponse: a resposta do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

duplicate()

Cria uma cópia do item e a anexa ao final do formulário.

Retornar

DateTimeItem: uma cópia desta DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getGeneralFeedback()

Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota.

Retornar

QuizFeedback: o feedback, se houver.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getHelpText()

Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).

Retornar

String: o texto de ajuda ou de descrição do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getId()

Recebe o identificador exclusivo do item.

Retornar

Integer: o ID do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getIndex()

Consegue o índice do item entre todos os itens no formulário.

Retornar

Integer: o índice do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPoints()

Retorna o valor em pontos de um item que pode ser avaliado.

Retornar

Integer: o número de pontos que uma pergunta vale.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getTitle()

Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Retornar

String: o título ou o texto do cabeçalho do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getType()

Recebe o tipo do item, representado como um ItemType.

Retornar

ItemType: o tipo do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

includesYear()

Determina se o item de data inclui uma opção de ano.

Retornar

Boolean: true se a data incluir uma configuração de ano; false, caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

isRequired()

Determina se o participante precisa responder à pergunta.

Retornar

Boolean: se o participante precisa responder à pergunta

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setGeneralFeedback(feedback)

Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta que não tem uma resposta correta ou incorreta (ou seja, perguntas que exigem avaliação manual).

Parâmetros

Nome	Tipo	Descrição
feedback	QuizFeedback	o novo feedback

Retornar

DateTimeItem: este DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setHelpText(text)

Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).

Parâmetros

Nome	Tipo	Descrição
text	String	o novo texto de ajuda

Retornar

DateTimeItem: este DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setIncludesYear(enableYear)

Define se o item de data inclui uma configuração de ano. O padrão para novos itens de data é true.

Parâmetros

Nome	Tipo	Descrição
enableYear	Boolean	true se a data incluir uma configuração de ano; false, caso contrário

Retornar

DateTimeItem: este DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setPoints(points)

Define o número de pontos de um item que pode ser avaliado. O padrão para novos itens é 0.

Parâmetros

Nome	Tipo	Descrição
points	Integer	o número de pontos que um item de pergunta vale

Retornar

DateTimeItem: este DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setRequired(enabled)

Define se o respondente precisa responder à pergunta.

Parâmetros

Nome	Tipo	Descrição
enabled	Boolean	se o participante precisa responder à pergunta

Retornar

DateTimeItem: o item atual (para encadeamento)

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setTitle(title)

Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Parâmetros

Nome	Tipo	Descrição
title	String	o novo título ou texto do cabeçalho

Retornar

DateTimeItem: este DateTimeItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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