Class 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)

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

المعلمات

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

الإرجاع

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


setFieldName(fieldName)

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

المعلمات

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

الإرجاع

DatePicker: أداة الاختيار هذه مخصّصة للربط.


setId(id)

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

المعلمات

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

الإرجاع

Widget: هذا الكائن، للتسلسل


setOnChangeAction(action)

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

المعلمات

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

الإرجاع

DatePicker: أداة الاختيار هذه مخصّصة للربط.


setTitle(title)

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

المعلمات

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

الإرجاع

DatePicker: أداة الاختيار هذه مخصّصة للربط.


setValueInMsSinceEpoch(valueMsEpoch)

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

المعلمات

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

الإرجاع

DatePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.


setValueInMsSinceEpoch(valueMsEpoch)

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

المعلمات

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

الإرجاع

DatePicker: أداة الاختيار هذه مخصّصة للربط.


setVisibility(visibility)

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

المعلمات

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

الإرجاع

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