حقل إدخال يسمح للمستخدمين بإدخال تاريخ ووقت
تتوفّر هذه الميزة لإضافات Google Workspace وتطبيقات Google Chat.
const dateTimePicker =
CardService.newDateTimePicker()
.setTitle('Enter the date and time.')
.setFieldName('date_time_field')
// Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or
// string is acceptable.
.setValueInMsSinceEpoch(1514775600)
// EDT time is 5 hours behind UTC.
.setTimeZoneOffsetInMins(-5 * 60)
.setOnChangeAction(
CardService.newAction().setFunctionName('handleDateTimeChange'),
);
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
|---|---|---|
set | Date | تُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. |
set | Date | تُستخدَم لضبط Action ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار. |
set | Date | لضبط عدد الدقائق التي يجب أن تكون فيها المنطقة الزمنية مختلفة عن التوقيت العالمي المنسق. |
set | Date | لضبط العنوان المعروض أعلى حقل الإدخال. |
set | Date | لضبط القيمة المعبأة مسبقًا في حقل الإدخال |
set | Date | لضبط القيمة المعبأة مسبقًا في حقل الإدخال |
مستندات تفصيلية
set
تُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، يجب أن يكون اسم الحقل المحدّد فريدًا.
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
field | String | الاسم الذي سيتمّ تعيينه لمصدر الإدخال هذا. |
الإرجاع
Date - أداة الاختيار هذه، لإنشاء سلاسل.
set
تُستخدَم لضبط Action ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار.
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
action | Action | الإجراء الذي يجب اتّخاذه |
الإرجاع
Date - أداة الاختيار هذه، لإنشاء سلاسل.
set
لضبط عدد الدقائق التي يجب أن تكون فيها المنطقة الزمنية مختلفة عن التوقيت العالمي المنسق. في حال ضبطها، يتم عرض التاريخ والوقت في المنطقة الزمنية المحدّدة. وإذا لم يتم ضبطها، يتم عرض الوقت في المنطقة الزمنية للمستخدم.
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
time | Integer | عدد الدقائق التي تختلف فيها المنطقة الزمنية عن التوقيت العالمي المنسق |
الإرجاع
Date: أداة الاختيار هذه لإنشاء سلاسل.
set
لضبط العنوان المعروض أعلى حقل الإدخال.
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
title | String | عنوان حقل الإدخال |
الإرجاع
Date - أداة الاختيار هذه، لإنشاء سلاسل.
set
لضبط القيمة المعبأة مسبقًا في حقل الإدخال
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
value | Number | القيمة التلقائية التي يتم وضعها في الإدخال كرقم، بالمللي ثانية منذ تاريخ بدء حساب الفترة ويتم تمثيله دائمًا كسلسلة في مَعلمات طلب إعادة الاتصال. |
الإرجاع
Date - أداة الاختيار هذه، لإنشاء سلاسل.
set
لضبط القيمة المعبأة مسبقًا في حقل الإدخال
المعلَمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | القيمة التلقائية التي يتم وضعها في الإدخال كسلسلة، بالملي ثانية منذ بداية حساب الوقت ويتم تمثيله دائمًا كسلسلة في مَعلمات طلب إعادة الاتصال. |
الإرجاع
Date - أداة الاختيار هذه، لإنشاء سلاسل.