Una pregunta que permite que el encuestado indique una fecha. Se puede acceder a los elementos o crearlos desde un Form
. Cuando se usan en un cuestionario, estos elementos se califican.
// Open a form by ID and add a new date item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateItem(); item.setTitle('When were you born?');
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. |
duplicate() | DateItem | 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) | DateItem | 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) | DateItem | Establece el texto de ayuda del elemento (a veces llamado texto descriptivo para elementos de diseño, como ImageItems , PageBreakItems y SectionHeaderItems ). |
setIncludesYear(enableYear) | DateItem | Establece si el elemento de fecha incluye una configuración de año. |
setPoints(points) | DateItem | Establece la cantidad de puntos que vale un elemento que se puede calificar. |
setRequired(enabled) | DateItem | Establece si el encuestado debe responder la pregunta. |
setTitle(title) | DateItem | 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. Los campos temporales del objeto Date
se ignoran. De forma predeterminada, solo se usan los campos de año, mes y día. 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, un día 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
DateItem
: Es un duplicado de este DateItem
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
DateItem
: Este DateItem
, 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
DateItem
: Este DateItem
, 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
DateItem
: Este DateItem
, 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
DateItem
: Este DateItem
, 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
DateItem
: 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
DateItem
: Este DateItem
, 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