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

روش ها

روش نوع برگشت شرح مختصر
create Response(response) Item Response یک Item Response جدید برای این مورد تاریخ-زمان ایجاد می کند.
duplicate() Date Time Item یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.
get General Feedback() Quiz Feedback بازخوردی را برمی‌گرداند که به پاسخ‌دهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده می‌شود.
get Help Text() String متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items نامیده می‌شود).
get Id() Integer شناسه منحصر به فرد مورد را دریافت می کند.
get Index() Integer نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.
get Points() Integer مقدار امتیاز یک مورد قابل نمره را برمی‌گرداند.
get Title() String عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ).
get Type() Item Type نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.
includes Year() Boolean تعیین می کند که آیا آیتم تاریخ شامل گزینه سال است یا خیر.
is Required() Boolean تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.
set General Feedback(feedback) Date Time Item بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.
set Help Text(text) Date Time Item متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).
set Includes Year(enableYear) Date Time Item تعیین می کند که آیا مورد تاریخ شامل تنظیم سال باشد یا خیر.
set Points(points) Date Time Item تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند.
set Required(enabled) Date Time Item تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.
set Title(title) Date Time Item عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).

مستندات دقیق

create Response(response)

یک Item Response جدید برای این مورد تاریخ-زمان ایجاد می کند. فیلد ثانیه شی Date نادیده گرفته می شود. به طور پیش فرض از فیلدهای سال، ماه، روز، ساعت و دقیقه استفاده می شود. اگر set Includes Year(enabled) روی false تنظیم شود، سال نیز نادیده گرفته می شود.

پارامترها

نام تایپ کنید توضیحات
response Date یک شیء Date که یک ماه، روز، ساعت، دقیقه و احتمالاً سال را نشان می دهد

بازگشت

Item Response - پاسخ مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

duplicate()

یک کپی از این مورد ایجاد می کند و آن را به انتهای فرم اضافه می کند.

بازگشت

Date Time Item - تکراری از این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get General Feedback()

بازخوردی را برمی‌گرداند که به پاسخ‌دهندگان هنگام پاسخ دادن به یک سؤال قابل نمره نشان داده می‌شود.

بازگشت

Quiz Feedback - بازخورد، در صورت وجود.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Help Text()

متن راهنمای مورد را دریافت می‌کند (گاهی اوقات متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items نامیده می‌شود).

بازگشت

String - متن راهنمای مورد یا متن توضیحات

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Id()

شناسه منحصر به فرد مورد را دریافت می کند.

بازگشت

Integer - شناسه مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Index()

نمایه مورد را از بین تمام موارد موجود در فرم دریافت می کند.

بازگشت

Integer - شاخص مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Points()

مقدار امتیاز یک مورد قابل نمره را برمی‌گرداند.

بازگشت

Integer - تعداد امتیازهایی که یک سوال ارزش دارد.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Title()

عنوان مورد را دریافت می کند (گاهی اوقات متن سرصفحه نامیده می شود، در مورد Section Header Item ).

بازگشت

String - عنوان یا متن سرصفحه مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

get Type()

نوع مورد را دریافت می کند که به عنوان یک Item Type نشان داده می شود.

بازگشت

Item Type - نوع مورد

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

includes Year()

تعیین می کند که آیا آیتم تاریخ شامل گزینه سال است یا خیر.

بازگشت

Boolean - true اگر تاریخ شامل تنظیم سال باشد. false اگر نه

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

is Required()

تعیین می کند که آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر.

بازگشت

Boolean - آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set General Feedback(feedback)

بازخورد را تنظیم می کند تا زمانی که پاسخ دهندگان به سؤال قابل نمره دهی که پاسخ صحیح یا نادرست ندارد (یعنی سؤالاتی که نیاز به درجه بندی دستی دارند) پاسخ می دهند، نشان داده شود.

پارامترها

نام تایپ کنید توضیحات
feedback Quiz Feedback بازخورد جدید

بازگشت

Date Time Item - این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Help Text(text)

متن راهنمای مورد را تنظیم می‌کند (گاهی اوقات به آن متن توضیحات برای موارد طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items گفته می‌شود).

پارامترها

نام تایپ کنید توضیحات
text String متن راهنما جدید

بازگشت

Date Time Item - این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Includes Year(enableYear)

تعیین می کند که آیا مورد تاریخ شامل تنظیم سال باشد یا خیر. پیش فرض برای آیتم های تاریخ جدید true است.

پارامترها

نام تایپ کنید توضیحات
enable Year Boolean true اگر تاریخ شامل تنظیم سال باشد. false اگر نه

بازگشت

Date Time Item - این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Points(points)

تعداد امتیازهایی را که یک آیتم قابل نمره ارزش دارد را تعیین می کند. پیش فرض برای موارد جدید 0 است.

پارامترها

نام تایپ کنید توضیحات
points Integer تعداد امتیاز یک مورد سوال ارزش دارد

بازگشت

Date Time Item - این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Required(enabled)

تعیین می کند که آیا پاسخ دهنده باید به سؤال پاسخ دهد یا خیر.

پارامترها

نام تایپ کنید توضیحات
enabled Boolean آیا پاسخ دهنده باید به سوال پاسخ دهد یا خیر

بازگشت

Date Time Item - مورد فعلی (برای زنجیر کردن)

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

set Title(title)

عنوان مورد را تنظیم می کند (گاهی اوقات به آن متن سرصفحه می گویند، در مورد Section Header Item ).

پارامترها

نام تایپ کنید توضیحات
title String عنوان یا متن سرصفحه جدید

بازگشت

Date Time Item - این Date Time Item ، برای زنجیر کردن

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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