Se usó la API de Cloud Translation para traducir esta página.

Class DateTimeItem

Es un elemento de pregunta que permite que el encuestado indique una fecha y una hora. Se puede acceder a los elementos o crearlos desde un Form. Cuando se usan en un cuestionario, se califican.

// 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 datos que se muestra	Descripción breve
`createResponse(response)`	`ItemResponse`	Crea un `ItemResponse` nuevo para este elemento de fecha y hora.
`duplicate()`	`DateTimeItem`	Crea una copia de este elemento y la agrega al final del formulario.
`getGeneralFeedback()`	`QuizFeedback`	Muestra los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.
`getHelpText()`	`String`	Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`getId()`	`Integer`	Obtiene el identificador único del artículo.
`getIndex()`	`Integer`	Obtiene el índice del elemento entre todos los elementos del formulario.
`getPoints()`	`Integer`	Muestra el valor en puntos de un elemento que se puede calificar.
`getTitle()`	`String`	Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un `SectionHeaderItem`).
`getType()`	`ItemType`	Obtiene el tipo del elemento, representado como un `ItemType`.
`includesYear()`	`Boolean`	Determina si el elemento de fecha incluye una opción de año.
`isRequired()`	`Boolean`	Determina si el encuestado debe responder la pregunta.
`setGeneralFeedback(feedback)`	`DateTimeItem`	Establece los comentarios que se mostrarán a las personas que responden cuando respondan una pregunta calificable que no tenga una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
`setHelpText(text)`	`DateTimeItem`	Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como `ImageItems`, `PageBreakItems` y `SectionHeaderItems`).
`setIncludesYear(enableYear)`	`DateTimeItem`	Establece si el elemento de fecha incluye un parámetro de configuración de año.
`setPoints(points)`	`DateTimeItem`	Establece la cantidad de puntos que vale un elemento que se puede calificar.
`setRequired(enabled)`	`DateTimeItem`	Establece si el encuestado debe responder la pregunta.
`setTitle(title)`	`DateTimeItem`	Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un `SectionHeaderItem`).

Documentación detallada

`createResponse(response)`

Crea un ItemResponse nuevo para este elemento de fecha y hora. Se ignora el campo de segundos del objeto Date. De forma predeterminada, se usan los campos de año, mes, día, hora y minuto. Si setIncludesYear(enabled) se establece en false, también se ignora el año.

Parámetros

Nombre	Tipo	Descripción
`response`	`Date`	Un objeto `Date` que representa un mes, un día, una hora, un minuto y, posiblemente, un año

Volver

ItemResponse: Es la respuesta del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`duplicate()`

Crea una copia de este elemento y la agrega al final del formulario.

Volver

DateTimeItem: Es un duplicado de este DateTimeItem para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getGeneralFeedback()`

Muestra los comentarios que se muestran a los encuestados cuando responden una pregunta calificable.

Volver

QuizFeedback: Los comentarios, si los hay.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getHelpText()`

Obtiene el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Volver

String: Es el texto de ayuda o la descripción del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getId()`

Obtiene el identificador único del artículo.

Volver

Integer: Es el ID del artículo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getIndex()`

Obtiene el índice del elemento entre todos los elementos del formulario.

Volver

Integer: Es el índice del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getPoints()`

Muestra el valor en puntos de un elemento que se puede calificar.

Volver

Integer: Es la cantidad de puntos que vale una pregunta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getTitle()`

Obtiene el título del elemento (a veces llamado texto del encabezado, en el caso de un SectionHeaderItem).

Volver

String: Es el título o el texto del encabezado del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`getType()`

Obtiene el tipo del elemento, representado como un ItemType.

Volver

ItemType: Es el tipo del elemento.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`includesYear()`

Determina si el elemento de fecha incluye una opción de año.

Volver

Boolean: true si la fecha incluye un parámetro de configuración de año; false si no

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`isRequired()`

Determina si el encuestado debe responder la pregunta.

Volver

Boolean: Indica si el encuestado debe responder la pregunta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setGeneralFeedback(feedback)`

Establece los comentarios que se mostrarán a las personas que responden cuando respondan una pregunta calificable que no tenga una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).

Parámetros

Nombre	Tipo	Descripción
`feedback`	`QuizFeedback`	los comentarios nuevos

Volver

DateTimeItem: Este DateTimeItem, para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setHelpText(text)`

Establece el texto de ayuda del elemento (a veces llamado texto de descripción para elementos de diseño como ImageItems, PageBreakItems y SectionHeaderItems).

Parámetros

Nombre	Tipo	Descripción
`text`	`String`	el nuevo texto de ayuda

Volver

DateTimeItem: Este DateTimeItem, para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setIncludesYear(enableYear)`

Establece si el elemento de fecha incluye un parámetro de configuración de año. El valor predeterminado para los elementos de fecha nuevos es true.

Parámetros

Nombre	Tipo	Descripción
`enableYear`	`Boolean`	`true` si la fecha incluye una configuración de año; `false` si no

Volver

DateTimeItem: Este DateTimeItem, para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setPoints(points)`

Establece la cantidad de puntos que vale un elemento que se puede calificar. El valor predeterminado para los elementos nuevos es 0.

Parámetros

Nombre	Tipo	Descripción
`points`	`Integer`	la cantidad de puntos que vale un elemento de pregunta

Volver

DateTimeItem: Este DateTimeItem, para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setRequired(enabled)`

Establece si el encuestado debe responder la pregunta.

Parámetros

Nombre	Tipo	Descripción
`enabled`	`Boolean`	si el encuestado debe responder la pregunta

Volver

DateTimeItem: Es el elemento actual (para encadenar).

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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

`setTitle(title)`

Establece el título del elemento (a veces llamado texto del encabezado, en el caso de un SectionHeaderItem).

Parámetros

Nombre	Tipo	Descripción
`title`	`String`	el texto del título o encabezado nuevo

Volver

DateTimeItem: Este DateTimeItem, para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

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