حقل إدخال يسمح بإدخال تاريخ.
متاحة لإضافات 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'), );
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
add | Widget | تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على الأداة. |
set | Date | تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. |
set | Widget | تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. |
set | Date | يضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار. |
set | Date | تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال. |
set | Date | تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال. |
set | Date | تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال. |
set | Widget | تضبط هذه السمة مستوى ظهور الأداة. |
مستندات تفصيلية
add Event Action(eventAction)
تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على الأداة.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
event | Event | تمثّل هذه السمة Event المطلوب إضافتها. |
الإرجاع
Widget — العنصر، للتسلسل.
set Field Name(fieldName)
تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدّد فريدًا.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
field | String | اسم مصدر الإدخال هذا |
الإرجاع
Date: أداة الاختيار هذه مخصّصة للربط.
set Id(id)
تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
id | String | معرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`. |
الإرجاع
Widget: هذا الكائن، للتسلسل
set On Change Action(action)
يضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
action | Action | الإجراء المطلوب اتّخاذه |
الإرجاع
Date: أداة الاختيار هذه مخصّصة للربط.
set Title(title)
تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
title | String | تمثّل هذه السمة عنوان حقل الإدخال. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة للربط.
set Value In Ms Since Epoch(valueMsEpoch)
تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | Number | القيمة التلقائية التي يتم وضعها في حقل الإدخال كرقم، بالمللي ثانية منذ تاريخ بدء حساب الفترة يتم استخدام تاريخ وقت بدء الحقبة فقط، ويتم تجاهل وقت بدء الحقبة. ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set Value In Ms Since Epoch(valueMsEpoch)
تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | القيمة التلقائية التي يتم وضعها في حقل الإدخال كسلسلة، بالمللي ثانية منذ بداية الفترة الزمنية. يتم استخدام تاريخ وقت بدء الحقبة فقط، ويتم تجاهل وقت بدء الحقبة. ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة للربط.
set Visibility(visibility)
تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
visibility | Visibility | Visibility الأداة |
الإرجاع
Widget — العنصر، للتسلسل.