Class DateTimePicker

DateTimePicker

حقل إدخال يتيح للمستخدمين إدخال تاريخ ووقت

يتيح التحقّق من صحة إرسال النماذج عند ضبط Action.setAllWidgetsAreRequired(allWidgetsAreRequired) على true أو تحديد هذه الأداة من خلال Action.addRequiredWidget(requiredWidget)، يتم حظر إجراء الإرسال ما لم يتم اختيار قيمة.

تتوفّر هذه الأداة لإضافات Google Workspace وتطبيقات Google Chat.

const dateTimePicker =
    CardService.newDateTimePicker()
        .setTitle('Enter the date and time.')
        .setFieldName('date_time_field')
        // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or
        // string is acceptable.
        .setValueInMsSinceEpoch(1514775600)
        // EDT time is 5 hours behind UTC.
        .setTimeZoneOffsetInMins(-5 * 60)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addEventAction(eventAction)	Widget	تضيف إجراء الحدث الذي يمكن تنفيذه على الأداة.
setFieldName(fieldName)	DateTimePicker	تضبط اسم الحقل الذي يعرّف أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل في واجهة المستخدم.
setHostAppDataSource(hostAppDataSource)	DateTimePicker	في أحد وكلاء Google Workspace Studio، تتيح هذه الطريقة لمتغيّرات الإدخال قبول نواتج التاريخ والوقت من خطوات أخرى في الوكيل.
setId(id)	Widget	تضبط المعرّف الفريد الذي تم تعيينه والذي يُستخدم لتحديد الأداة المطلوب تغييرها.
setOnChangeAction(action)	DateTimePicker	تضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة الإدخال في أداة الاختيار.
setTimeZoneOffsetInMins(timeZoneOffsetMins)	DateTimePicker	تضبط عدد الدقائق التي يجب أن تكون المنطقة الزمنية متأخرة عن التوقيت العالمي المنسّق.
setTitle(title)	DateTimePicker	تضبط العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	تضبط القيمة التي يتم ملؤها مسبقًا في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)	DateTimePicker	تضبط القيمة التي يتم ملؤها مسبقًا في حقل الإدخال.
setVisibility(visibility)	Widget	تضبط مستوى رؤية الأداة.

مستندات تفصيلية

addEventAction(eventAction)

تضيف إجراء الحدث الذي يمكن تنفيذه على الأداة.

المَعلمات

الاسم	النوع	الوصف
eventAction	EventAction	EventAction المطلوب إضافته

الإرجاع

Widget — الكائن، من أجل الربط

---

setFieldName(fieldName)

تضبط اسم الحقل الذي يعرّف أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل في واجهة المستخدم. يظهر اسم الحقل للمستخدم. هذا الحقل مطلوب ويجب أن يكون اسم الحقل المحدّد فريدًا.

المَعلمات

الاسم	النوع	الوصف
fieldName	String	الاسم المطلوب تعيينه لهذا الإدخال

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setHostAppDataSource(hostAppDataSource)

في أحد وكلاء Google Workspace Studio، تتيح هذه الطريقة لمتغيّرات الإدخال قبول نواتج التاريخ والوقت من خطوات أخرى في الوكيل. على سبيل المثال، يمكنك تلقّي وقت إرسال رسالة Gmail أو التاريخ الذي تم فيه تحديد موعد لحدث في "تقويم Google".

تتوفّر هذه الطريقة فقط لإضافات Google Workspace التي توسّع Google Workspace Studio.

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const dateTimePicker = CardService.newDateTimePicker()
                          .setTitle('Enter the date and time.')
                          .setFieldName('date_time_field')
                          .setHostAppDataSource(hostAppDataSource);

المَعلمات

الاسم	النوع	الوصف
hostAppDataSource	HostAppDataSource	مصدر البيانات

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setId(id)

تضبط المعرّف الفريد الذي تم تعيينه والذي يُستخدم لتحديد الأداة المطلوب تغييرها. لا يمكن تغيير الأداة إلا في الإضافات.

المَعلمات

الاسم	النوع	الوصف
id	String	معرّف الأداة، الذي يتضمّن 64 حرفًا بحد أقصى ويكون بالتنسيق `[a-zA-Z0-9-]+`

الإرجاع

Widget — هذا الكائن، من أجل الربط

---

setOnChangeAction(action)

تضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة الإدخال في أداة الاختيار.

المَعلمات

الاسم	النوع	الوصف
action	Action	الإجراء المطلوب اتّخاذه

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setTimeZoneOffsetInMins(timeZoneOffsetMins)

تضبط عدد الدقائق التي يجب أن تكون المنطقة الزمنية متأخرة عن التوقيت العالمي المنسّق. في حال ضبط هذه الطريقة، يتم عرض التاريخ والوقت في المنطقة الزمنية المحدّدة. في حال عدم ضبطها، يتم عرض الوقت في المنطقة الزمنية للمستخدم.

المَعلمات

الاسم	النوع	الوصف
timeZoneOffsetMins	Integer	عدد الدقائق التي تكون المنطقة الزمنية متأخرة عن التوقيت العالمي المنسّق

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setTitle(title)

تضبط العنوان المعروض أعلى حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
title	String	عنوان حقل الإدخال

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setValueInMsSinceEpoch(valueMsEpoch)

تضبط القيمة التي يتم ملؤها مسبقًا في حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
valueMsEpoch	Number	القيمة التلقائية التي يتم وضعها في حقل الإدخال كرقم، بالملّي ثانية منذ بداية الحقبة يتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج.

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setValueInMsSinceEpoch(valueMsEpoch)

تضبط القيمة التي يتم ملؤها مسبقًا في حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
valueMsEpoch	String	القيمة التلقائية التي يتم وضعها في حقل الإدخال كسلسلة، بالملّي ثانية منذ بداية الحقبة يتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج.

الإرجاع

DateTimePicker — أداة الاختيار هذه، من أجل الربط

---

setVisibility(visibility)

تضبط مستوى رؤية الأداة. القيمة التلقائية هي `VISIBLE`.

المَعلمات

الاسم	النوع	الوصف
visibility	Visibility	Visibility للأداة

الإرجاع

Widget — الكائن، من أجل الربط