تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`setFieldName(fieldName)`	`DateTimePicker`	تُستخدَم لضبط اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
`setOnChangeAction(action)`	`DateTimePicker`	تُستخدَم لضبط `Action` ينفّذها النص البرمجي كلما تغيّرت إدخالات أداة الاختيار.
`setTimeZoneOffsetInMins(timeZoneOffsetMins)`	`DateTimePicker`	لضبط عدد الدقائق التي يجب أن تكون فيها المنطقة الزمنية مختلفة عن التوقيت العالمي المنسق.
`setTitle(title)`	`DateTimePicker`	لضبط العنوان المعروض أعلى حقل الإدخال.
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	لضبط القيمة المعبأة مسبقًا في حقل الإدخال
`setValueInMsSinceEpoch(valueMsEpoch)`	`DateTimePicker`	لضبط القيمة المعبأة مسبقًا في حقل الإدخال

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

`setFieldName(fieldName)`

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