Class DateTimePicker

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
منتقي التاريخ

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

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تحدد عدد دقائق معادلة المنطقة الزمنية من UTC.
setTitle(title)DateTimePickerلضبط العنوان المعروض أعلى حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerلضبط القيمة التي تم ملؤها مسبقًا لضبطها في حقل الإدخال.
setValueInMsSinceEpoch(valueMsEpoch)DateTimePickerلضبط القيمة التي تم ملؤها مسبقًا لضبطها في حقل الإدخال.

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

setFieldName(fieldName)

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

المعلّمات

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

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.


setOnChangeAction(action)

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

المعلّمات

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

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.


setTimeZoneOffsetInMins(timeZoneOffsetMins)

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

المعلّمات

الاسمالنوعالوصف
timeZoneOffsetMinsIntegerعدد دقائق معادلة المنطقة الزمنية من التوقيت العالمي المُنسّق (UTC).

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.


setTitle(title)

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

المعلّمات

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

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.


setValueInMsSinceEpoch(valueMsEpoch)

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

المعلّمات

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

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.


setValueInMsSinceEpoch(valueMsEpoch)

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

المعلّمات

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

تذكرة ذهاب وعودة

DateTimePicker — هذا المُنتقي للسلسلة.