דף זה תורגם על ידי Cloud Translation API.

Class DateTimeItem

פריט שאלה שמאפשר למשיבים לציין תאריך ושעה. ניתן לגשת לפריטים או נוצר מ-Form. כשנעשה שימוש בפריטים האלה בבוחן, הפריטים האלה מקבלים ציון.

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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 – מזהה הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:

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