حقل إدخال يسمح للمستخدمين بإدخال وقت.
متاحة لإضافات Google Workspace وتطبيقات Google Chat.
var 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)
لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في كائن الحدث الذي يتم إنشاؤه عند حدوث تفاعل في واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدد فريدًا.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
fieldName | String | الاسم الذي سيتم تعيينه لهذا الإدخال. |
استرجاع الكرة
TimePicker
: أداة الاختيار هذه للتسلسل.
setHours(hours)
تحدِّد هذه السياسة قيمة الساعات التي يتم ملؤها مسبقًا والتي يجب ضبطها في حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
hours | Integer | وتتراوح القيمة التلقائية للساعة في مصدر الإدخال بين 0 و23. ويتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال في النموذج. |
استرجاع الكرة
TimePicker
: أداة الاختيار هذه للتسلسل.
setMinutes(minutes)
تحدِّد هذه السياسة قيمة الدقائق التي يتم ملؤها مسبقًا والتي يجب ضبطها في حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
minutes | Integer | تتراوح القيمة التلقائية للدقائق المُدرَجة في المدخل بين 0 و59. ويتم تمثيلها دائمًا كسلسلة في مَعلمات معاودة الاتصال في النموذج. |
استرجاع الكرة
TimePicker
: أداة الاختيار هذه للتسلسل.
setOnChangeAction(action)
لضبط Action
الذي ينفّذه النص البرمجي كلما تغير إدخال أداة الاختيار.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء المطلوب اتخاذه. |
استرجاع الكرة
TimePicker
: أداة الاختيار هذه للتسلسل.
setTitle(title)
لضبط العنوان المعروض أعلى حقل الإدخال.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان حقل الإدخال |
استرجاع الكرة
TimePicker
: أداة الاختيار هذه للتسلسل.