Class TimePicker

أداة اختيارالوقت

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

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

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

الطُرق

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

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

setFieldName(fieldName)

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

المعلمات

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

الإرجاع

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


setHours(hours)

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

المعلمات

الاسمالنوعالوصف
hoursIntegerتتراوح القيمة التلقائية للساعة التي يتم وضعها في الإدخال من 0 إلى 23. ويتم دائمًا عرضه كسلسلة في مَعلمات طلب إعادة الاتصال.

الإرجاع

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


setMinutes(minutes)

تُستخدَم لضبط قيمة الدقائق المعبأة مسبقًا في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
minutesIntegerتتراوح القيمة التلقائية للدقائق في الإدخال بين 0 و59. ويتم دائمًا عرضه كسلسلة في مَعلمات طلب إعادة الاتصال.

الإرجاع

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


setOnChangeAction(action)

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

المعلمات

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

الإرجاع

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


setTitle(title)

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

المعلمات

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

الإرجاع

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