المكون DatePickerAndroid في React Native
مهملة: استعمل إحدى الحزم من المجتمع بدلًا عنها.
تُستخدم 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
.
dataSetAction()
static dateSetAction()
اختير تاريخ.
dismissedAction()
static dismissedAction()
رُفض مربع حوار منتقي التّاريخ.