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

الطُرق

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

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

setFieldName(fieldName)

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

المعلمات

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

الإرجاع

DatePicker - أداة الاختيار هذه، لإنشاء سلاسل.


setOnChangeAction(action)

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

المعلمات

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

الإرجاع

DatePicker - أداة الاختيار هذه، لإنشاء سلاسل.


setTitle(title)

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

المعلمات

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

الإرجاع

DatePicker - أداة الاختيار هذه، لإنشاء سلاسل.


setValueInMsSinceEpoch(valueMsEpoch)

لضبط القيمة المعبأة مسبقًا في حقل الإدخال

المعلمات

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

الإرجاع

DatePicker - أداة الاختيار هذه، لإنشاء سلاسل.


setValueInMsSinceEpoch(valueMsEpoch)

لضبط القيمة المعبأة مسبقًا في حقل الإدخال

المعلمات

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

الإرجاع

DatePicker - أداة الاختيار هذه، لإنشاء سلاسل.