Class DateTimeItem

日期时间商品

一个问题项，可让受访者指明日期和时间。您可以通过 Form 访问或创建内容。在知识问答中使用这些题目时，系统会为其评分。

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

方法

方法	返回类型	简介
createResponse(response)	ItemResponse	为此日期时间项创建新的 ItemResponse。
duplicate()	DateTimeItem	创建此项的副本，并将其附加到表单的末尾。
getGeneralFeedback()	QuizFeedback	返回在回复可评分题目时向回答者显示的反馈。
getHelpText()	String	获取项的帮助文本（对于 ImageItems、PageBreakItems 和 SectionHeaderItems 等布局项，有时也称为说明文本）。
getId()	Integer	获取内容的唯一标识符。
getIndex()	Integer	获取表单中所有项中的项的索引。
getPoints()	Integer	返回可评分的项的分值。
getTitle()	String	获取项的标题（对于 SectionHeaderItem，有时称为标题文本）。
getType()	ItemType	获取项的类型，表示为 ItemType。
includesYear()	Boolean	确定日期项是否包含年份选项。
isRequired()	Boolean	确定回复者是否必须回答该问题。
setGeneralFeedback(feedback)	DateTimeItem	设置在回复者回答没有正确或错误答案的可评分问题（即需要手动评分的题目）时向其显示的反馈。
setHelpText(text)	DateTimeItem	设置项的帮助文本（对于布局项，有时也称为说明文本，例如 ImageItems、PageBreakItems 和 SectionHeaderItems）。
setIncludesYear(enableYear)	DateTimeItem	设置日期项是否包含年份设置。
setPoints(points)	DateTimeItem	设置可评分的项目的分值。
setRequired(enabled)	DateTimeItem	设置回复者是否必须回答该问题。
setTitle(title)	DateTimeItem	设置项的标题（对于 SectionHeaderItem，有时称为标题文本）。

详细文档

createResponse(response)

为此日期时间项创建新的 ItemResponse。系统会忽略 Date 对象的秒字段；默认情况下，系统会使用年、月、日、小时和分钟字段。如果 setIncludesYear(enabled) 设置为 false，系统也会忽略年份。

参数

名称	类型	说明
response	Date	一个 Date 对象，表示月份、日期、小时、分钟，可能还包括年份

返回

ItemResponse - 内容响应

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

duplicate()

创建此项的副本，并将其附加到表单的末尾。

返回

DateTimeItem - 此 DateTimeItem 的副本，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getGeneralFeedback()

返回在回复可评分题目时向回答者显示的反馈。

返回

QuizFeedback - 反馈（如果有）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getHelpText()

获取项的帮助文本（对于 ImageItems、PageBreakItems 和 SectionHeaderItems 等布局项，有时也称为说明文本）。

返回

String - 商品的帮助文本或说明文字

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getId()

获取内容的唯一标识符。

返回

Integer - 商品的 ID

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getIndex()

获取表单中所有项中的项的索引。

返回

Integer - 项的索引

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getPoints()

返回可评分的项的分值。

返回

Integer - 题目的分值。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getTitle()

获取项的标题（对于 SectionHeaderItem，有时称为标题文本）。

返回

String - 商品的标题或标题文本

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

getType()

获取项的类型，表示为 ItemType。

返回

ItemType - 内容的类型

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

includesYear()

确定日期项是否包含年份选项。

返回

Boolean - 如果日期包含年份设置，则为 true；否则为 false

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

isRequired()

确定回复者是否必须回答该问题。

返回

Boolean - 回复者是否必须回答此问题

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setGeneralFeedback(feedback)

设置在回复者回答没有正确或错误答案的可评分问题（即需要手动评分的题目）时向其显示的反馈。

参数

名称	类型	说明
feedback	QuizFeedback	新反馈

返回

DateTimeItem - 此 DateTimeItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setHelpText(text)

设置项的帮助文本（对于布局项，有时也称为说明文本，例如 ImageItems、PageBreakItems 和 SectionHeaderItems）。

参数

名称	类型	说明
text	String	新的帮助文本

返回

DateTimeItem - 此 DateTimeItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setIncludesYear(enableYear)

设置日期项是否包含年份设置。新日期项的默认值为 true。

参数

名称	类型	说明
enableYear	Boolean	如果日期包含年份设置，则为 true；否则为 false

返回

DateTimeItem - 此 DateTimeItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setPoints(points)

设置可评分的项目的分值。新商品的默认值为 0。

参数

名称	类型	说明
points	Integer	题目项对应的分数

返回

DateTimeItem - 此 DateTimeItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setRequired(enabled)

设置回复者是否必须回答该问题。

参数

名称	类型	说明
enabled	Boolean	受访者是否必须回答此问题

返回

DateTimeItem - 当前项（用于链接）

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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

---

setTitle(title)

设置项的标题（对于 SectionHeaderItem，有时称为标题文本）。

参数

名称	类型	说明
title	String	新标题或标题文字

返回

DateTimeItem - 此 DateTimeItem，用于链式调用

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

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