Class DateTimePicker

أداة اختيارالتاريخوالوقت

حقل إدخال يسمح للمستخدمين بإدخال التاريخ والوقت.

يتيح التحقّق من صحة عمليات إرسال النماذج. عند ضبط 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'),
        );

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setFieldName(fieldName)DateTimePickerتضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHostAppDataSource(hostAppDataSource)DateTimePickerفي وكيل Google Workspace Studio، تتيح متغيرات الإدخال قبول مخرجات التاريخ والوقت من خطوات أخرى في الوكيل.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setOnChangeAction(action)DateTimePickerيضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
setTimeZoneOffsetInMins(timeZoneOffsetMins)DateTimePickerتضبط هذه السمة عدد الدقائق التي يجب أن يتم فيها تعديل المنطقة الزمنية من التوقيت العالمي المتفق عليه.
setTitle(title)DateTimePickerتضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerتضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.

مستندات تفصيلية

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المعلمات

الاسمالنوعالوصف
eventActionEventActionتمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل.

setFieldName(fieldName)

تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم. يظهر اسم الحقل للمستخدم. مطلوب، ويجب أن يكون اسم الحقل المحدّد فريدًا.

المعلمات

الاسمالنوعالوصف
fieldNameStringاسم مصدر الإدخال هذا

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setHostAppDataSource(hostAppDataSource)

في وكيل Google Workspace Studio، تتيح متغيرات الإدخال قبول مخرجات التاريخ والوقت من خطوات أخرى في الوكيل. على سبيل المثال، يمكنك تلقّي وقت إرسال رسالة Gmail أو تاريخ جدولة حدث في "تقويم Google".

لا تتوفّر إلا لإضافات Google Workspace التي توسّع نطاق Google Workspace Studio. 

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);

المعلمات

الاسمالنوعالوصف
hostAppDataSourceHostAppDataSourceمصدر البيانات

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setId(id)

تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.

المعلمات

الاسمالنوعالوصف
idStringمعرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا الكائن، للتسلسل

setOnChangeAction(action)

يضبط هذا الخيار Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.

المعلمات

الاسمالنوعالوصف
actionActionالإجراء المطلوب اتّخاذه

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setTimeZoneOffsetInMins(timeZoneOffsetMins)

تضبط هذه السمة عدد الدقائق التي يجب أن يتم فيها تعديل المنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال ضبطها، يتم عرض التاريخ والوقت في المنطقة الزمنية المحدّدة. في حال عدم ضبطها، يتم عرض الوقت في المنطقة الزمنية للمستخدم.

المعلمات

الاسمالنوعالوصف
timeZoneOffsetMinsIntegerعدد الدقائق التي يتم فيها إزاحة المنطقة الزمنية عن التوقيت العالمي المنسّق

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setTitle(title)

تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.

المعلمات

الاسمالنوعالوصف
titleStringتمثّل هذه السمة عنوان حقل الإدخال.

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setValueInMsSinceEpoch(valueMsEpoch)

تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
valueMsEpochNumberالقيمة التلقائية التي يتم وضعها في حقل الإدخال كرقم، بالمللي ثانية منذ تاريخ بدء حساب الفترة ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج.

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setValueInMsSinceEpoch(valueMsEpoch)

تضبط هذه السمة القيمة التي سيتم ملؤها مسبقًا في حقل الإدخال.

المعلمات

الاسمالنوعالوصف
valueMsEpochStringالقيمة التلقائية التي يتم وضعها في حقل الإدخال كسلسلة، بالمللي ثانية منذ بداية الفترة الزمنية. ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال بالنموذج.

الإرجاع

DateTimePicker: أداة الاختيار هذه مخصّصة لربط السلاسل.

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.

المعلمات

الاسمالنوعالوصف
visibilityVisibilityVisibility الأداة

الإرجاع

Widget — العنصر، للتسلسل.