Esta página foi traduzida pela API Cloud Translation.

Class DateTimeItem

Um item de pergunta que permite ao participante indicar uma data e hora. Os itens podem ser acessados ou criado com base 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 esse item de data-hora.
`duplicate()`	`DateTimeItem`	Cria uma cópia desse item e a anexa ao final do formulário.
`getGeneralFeedback()`	`QuizFeedback`	Retorna o feedback que é mostrado aos participantes quando eles respondem a uma pergunta que pode ser avaliada.
`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`	Extrai o identificador exclusivo do item.
`getIndex()`	`Integer`	Recebe o índice do item entre todos os itens do formulário.
`getPoints()`	`Integer`	Retorna a pontuação de um item que pode ser avaliado.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como `ItemType`.
`includesYear()`	`Boolean`	Determina se o item de data inclui uma opção de ano.
`isRequired()`	`Boolean`	Determina se o respondente precisa responder à pergunta.
`setGeneralFeedback(feedback)`	`DateTimeItem`	Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta com nota que não têm uma resposta correta ou incorreta (ou seja, perguntas que exigem correçã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 participante precisa responder à pergunta.
`setTitle(title)`	`DateTimeItem`	Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`.

Documentação detalhada

`createResponse(response)`

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

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 precisam de 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 desse item e a anexa ao final do formulário.

Retornar

DateTimeItem: uma cópia deste DateTimeItem para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 que é mostrado aos participantes quando eles respondem a uma pergunta que pode ser avaliada.

Retornar

QuizFeedback: o feedback, se houver.

Autorização

Os scripts que usam esse método precisam de 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 precisam de autorização com um ou mais dos seguintes escopos:

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

`getId()`

Extrai o identificador exclusivo do item.

Retornar

Integer: o código do item.

Autorização

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

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

`getIndex()`

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

Retornar

Integer: o índice do item.

Autorização

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

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

`getPoints()`

Retorna a pontuação de um item que pode ser avaliado.

Retornar

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

Autorização

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

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

`getTitle()`

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

Retornar

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

Autorização

Os scripts que usam esse método precisam de 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 ItemType.

Retornar

ItemType: o tipo do item.

Autorização

Os scripts que usam esse método precisam de 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 se não for

Autorização

Os scripts que usam esse método precisam de 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 respondente precisa responder à pergunta.

Retornar

Boolean: se o participante precisa responder à pergunta.

Autorização

Os scripts que usam esse método precisam de 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 com nota que não têm uma resposta correta ou incorreta (ou seja, perguntas que exigem correçã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 precisam de 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 precisam de 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 precisam de 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 precisam de 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 participante precisa responder à pergunta.

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	se o entrevistado deve responder à pergunta

Retornar

DateTimeItem: o item atual (para encadeamento).

Autorização

Os scripts que usam esse método precisam de 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 de cabeçalho, no caso de uma 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 precisam de autorização com um ou mais dos seguintes escopos:

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