Es una pregunta que permite que el encuestado indique una fecha y hora. Se puede acceder a los elementos o crearlos desde una Form. Cuando se usan en un cuestionario, estos elementos se califican.
// 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 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 a una pregunta que se puede calificar. |
getHelpText() | String | Obtiene el texto de ayuda del elemento (a veces llamado texto descriptivo para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems). |
getId() | Integer | Obtiene el identificador único del elemento. |
getIndex() | Integer | Obtiene el índice del elemento entre todos los elementos del formulario. |
getPoints() | Integer | Muestra la puntuación 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 SectionHeaderItem). |
getType() | ItemType | Obtiene el tipo del elemento, representado como ItemType. |
includesYear() | Boolean | Determina si el elemento de fecha incluye la opción de año. |
isRequired() | Boolean | Determina si el encuestado debe responder la pregunta. |
setGeneralFeedback(feedback) | DateTimeItem | Configura los comentarios que se mostrarán a los encuestados cuando respondan a una pregunta calificable que no tiene 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 descriptivo para elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems). |
setIncludesYear(enableYear) | DateTimeItem | Establece si el elemento de fecha incluye una 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 de encabezado, en el caso de SectionHeaderItem). |
Documentación detallada
createResponse(response)
Crea un ItemResponse nuevo para este elemento de fecha y hora. El campo de segundos del objeto Date se ignora. De forma predeterminada, se usan los campos de año, mes, día, hora y minuto. Si setIncludesYear(enabled) se configura como false, también se ignora el año.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
response | Date | un objeto Date que representa un mes, día, hora, minuto y, posiblemente, un año |
Devolvedor
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 alcances:
-
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.
Devolvedor
DateTimeItem: Es un duplicado de este DateTimeItem para encadenamiento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 a una pregunta que se puede calificar.
Devolvedor
QuizFeedback: Es el comentario, si corresponde.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 descriptivo para los elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Obtiene el identificador único del elemento.
Devolvedor
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 alcances:
-
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.
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Muestra la puntuación de un elemento que se puede calificar.
Devolvedor
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 alcances:
-
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 SectionHeaderItem).
Devolvedor
String: Es el título o 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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Obtiene el tipo del elemento, representado como ItemType.
Devolvedor
ItemType: Es el tipo de elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
includesYear()
Determina si el elemento de fecha incluye la opción de año.
Devolvedor
Boolean: Es true si la fecha incluye una configuración de año; false si no es así.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Determina si el encuestado debe responder la pregunta.
Devolvedor
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 alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Configura los comentarios que se mostrarán a los encuestados cuando respondan a una pregunta calificable que no tiene una respuesta correcta o incorrecta (es decir, preguntas que requieren calificación manual).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
feedback | QuizFeedback | el nuevo comentario |
Devolvedor
DateTimeItem: Este DateTimeItem, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 descriptivo para elementos de diseño, como ImageItems, PageBreakItems y SectionHeaderItems).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
text | String | el nuevo texto de ayuda |
Devolvedor
DateTimeItem: Este DateTimeItem, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setIncludesYear(enableYear)
Establece si el elemento de fecha incluye una configuración de año. La configuración predeterminada para los nuevos elementos de fecha es true.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
enableYear | Boolean | true si la fecha incluye una configuración de año; false si no es así |
Devolvedor
DateTimeItem: Este DateTimeItem, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 una pregunta |
Devolvedor
DateTimeItem: Este DateTimeItem, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 |
Devolvedor
DateTimeItem: Es el elemento actual (para el encadenamiento).
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
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 de encabezado, en el caso de SectionHeaderItem).
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
title | String | el nuevo título o texto del encabezado |
Devolvedor
DateTimeItem: Este DateTimeItem, para encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms