Class DateTimePicker

DateTimePicker

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

متاحة لإضافات Google Workspace وتطبيقات Google Chat.

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

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

المَعلمات

الاسمالنوعالوصف
fieldNameStringالاسم الذي سيتم تعيينه لهذا الإدخال.

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.


setOnChangeAction(action)

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

المَعلمات

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

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

المَعلمات

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

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.


setTitle(title)

لضبط العنوان المعروض أعلى حقل الإدخال.

المَعلمات

الاسمالنوعالوصف
titleStringعنوان حقل الإدخال

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.


setValueInMsSinceEpoch(valueMsEpoch)

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

المَعلمات

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

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.


setValueInMsSinceEpoch(valueMsEpoch)

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

المَعلمات

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

استرجاع الكرة

DateTimePicker: أداة الاختيار هذه للتسلسل.