حقل إدخال يسمح للمستخدمين بإدخال الوقت.
يتوفّر هذا الخيار لإضافات 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
— أداة الاختيار هذه، للسلسلة.