Class DatePicker

DatePicker

حقل إدخال يسمح بإدخال تاريخ.

متاحة لإضافات Google Workspace وتطبيقات Google Chat.

const dateTimePicker =
    CardService.newDatePicker()
        .setTitle('Enter the date.')
        .setFieldName('date_field')
        // Set default value as Jan 1, 2018 UTC. Either a number or string is
        // acceptable.
        .setValueInMsSinceEpoch(1514775600)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addEventAction(eventAction)	Widget	تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setFieldName(fieldName)	DatePicker	تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setId(id)	Widget	يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها.
setOnChangeAction(action)	DatePicker	يضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
setTitle(title)	DatePicker	تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)	DatePicker	تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setVisibility(visibility)	Widget	تضبط هذه السمة مستوى ظهور الأداة.

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

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المَعلمات

الاسم	النوع	الوصف
eventAction	EventAction	تمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل

---

setFieldName(fieldName)

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

المَعلمات

الاسم	النوع	الوصف
fieldName	String	اسم مصدر الإدخال هذا

الإرجاع

‫DatePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setId(id)

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

المَعلمات

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

الإرجاع

Widget: هذا العنصر، للتسلسل

---

setOnChangeAction(action)

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

المَعلمات

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

الإرجاع

‫DatePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setTitle(title)

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

المَعلمات

الاسم	النوع	الوصف
title	String	تمثّل هذه السمة عنوان حقل الإدخال.

الإرجاع

‫DatePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setValueInMsSinceEpoch(valueMsEpoch)

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

المَعلمات

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

الإرجاع

‫DatePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setValueInMsSinceEpoch(valueMsEpoch)

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

المَعلمات

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

الإرجاع

‫DatePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setVisibility(visibility)

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

المَعلمات

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

الإرجاع

Widget — العنصر، للتسلسل