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

Class DateTimePicker

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

تتوفّر هذه الميزة لإضافات 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)`

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