تمت ترجمة هذه الصفحة بواسطة 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