حقل إدخال يسمح للمستخدمين بإدخال التاريخ والوقت.
يتيح التحقّق من صحة عمليات إرسال النماذج. عند ضبط Action.setAllWidgetsAreRequired(allWidgetsAreRequired) على true أو تحديد هذه الأداة من خلال Action.addRequiredWidget(requiredWidget)، يتم حظر إجراء الإرسال ما لم يتم تحديد قيمة.
متاحة لإضافات 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 | في مسار Google Workspace، تسمح متغيرات الإدخال بقبول مخرجات التاريخ والوقت من خطوات أخرى في المسار. |
set | Date | يضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار. |
set | Date | تضبط هذه السمة عدد الدقائق التي يجب أن تكون المنطقة الزمنية متأخرة أو متقدمة عن التوقيت العالمي المتفق عليه. |
set | Date | تضبط هذه السمة العنوان المعروض فوق حقل الإدخال. |
set | Date | تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال. |
set | Date | تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال. |
مستندات تفصيلية
set
تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدّد فريدًا.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
field | String | اسم مصدر الإدخال هذا |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
في مسار Google Workspace، تسمح متغيرات الإدخال بقبول مخرجات التاريخ والوقت من خطوات أخرى في المسار. على سبيل المثال، يمكنك تلقّي وقت إرسال رسالة Gmail أو تاريخ جدولة حدث في "تقويم Google".
متاحة فقط من خلال برنامج Gemini Alpha لإضافات Google Workspace التي توسّع نطاق استخدام Google Workspace Flows.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
host | Host | مصدر البيانات |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
يضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
action | Action | الإجراء المطلوب اتّخاذه |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة عدد الدقائق التي يجب أن تكون المنطقة الزمنية متأخرة أو متقدمة عن التوقيت العالمي المتفق عليه. في حال ضبطها، يتم عرض التاريخ والوقت في المنطقة الزمنية المحدّدة. في حال عدم ضبطها، يتم عرض الوقت في المنطقة الزمنية للمستخدم.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
time | Integer | عدد الدقائق التي يتم فيها إزاحة المنطقة الزمنية عن التوقيت العالمي المنسّق (UTC). |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة العنوان المعروض فوق حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
title | String | تمثّل هذه السمة عنوان حقل الإدخال. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | Number | القيمة التلقائية التي يتم وضعها في حقل الإدخال كرقم، بالمللي ثانية منذ تاريخ بدء حساب الفترة ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.
set
تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
value | String | القيمة التلقائية التي يتم وضعها في حقل الإدخال كسلسلة، بالمللي ثانية منذ بداية الفترة الزمنية ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج. |
الإرجاع
Date: أداة الاختيار هذه مخصّصة لربط السلاسل.