ReactNative/datepickerandroid

مهملة: يمكنك استخدام react-native-community/datetimepicker@ بدلًا منها.

تُستخدم DatePickerAndroid لإظهار مُنتقي التّاريخ (date picker) المعياريّ على منصّة Android.

مثال

try {
  const {
    action,
    year,
    month,
    day
  } = await DatePickerAndroid.open({
    // Use `new Date()` for current date.
    // May 25 2020. Month 0 is January.
    date: new Date(2020, 4, 25)
  });
  if (action !== DatePickerAndroid.dismissedAction) {
    // Selected year, month (0-11), day
  }
} catch ({ code, message }) {
  console.warn('Cannot open date picker', message);
}

التوابع

‪open()

static open(options)

يفتح مربع حوار منتقي التّاريخ المعياري لمنصّة Android.

المفاتيح المتاحة للكائن options:

• date (كائن Date، أو طابع زمنيّ (timestamp) بالميلي ثانية): التّاريخ الذي سيظهر افتراضيًّا.
• minDate (كائن Date، أو طابع زمني بالميلي ثانية): أدنى تاريخ يمكن اختياره.
• maxDate (كائن Date، أو طابع زمني بالميلي ثانية): أعلى تاريخ يمكن اختياره.
• mode (قيمة متعدّدة enum('calendar', 'spinner', 'default')): لتحديد وضع منتقي التّاريخ من الأوضاع التّالية:
  • 'calendar' : إظهار مُنتقي التّاريخ بوضع التّقويم (calendar).
  • 'spinner' : إظهار مُنتقي التّاريخ بالوضع الدوّار (spinner).
  • 'default' : إظهار مُنتقي التّاريخ بالوضع الافتراضيّ الموافق لإصدار Android.

يُعيد هذه التّابع وعدًا (Promise) يُقبل ككائنٍ يحوي المفاتيح action، وyear، وmonth (0-11)، وday إذا اختار المستخدم تاريخًا، أو يُقبل بجعل قيمة المفتاح action مساوية لـ DateePickerAndroid.dismissedAction، وبعدم تعريف باقي المفاتيح إذا رُفض (dismiss) مربّع الحوار، ويتفحّص هذا التّابع دائمًا، أن action يساوي DatePickerAndroid.dateSetAction قبل قراءة القيم.

ملاحظة: هنالك بعض المشاكل في مربع حوار منتقي التّاريخ على منصّة Android في الإصدار 4 وما قبله، وذلك عند استخدام minDate، وmaxDate.

‪dateSetAction()

static dateSetAction()

اختير تاريخ.

dismissedAction()‎

static dismissedAction()

رُفض مربع حوار منتقي التّاريخ.

مصادر

• صفحة DatePickerAndroid في توثيق React Native الرسميّ