عرض مصدر ReactNative/datepickerandroid

<noinclude>{{DISPLAYTITLE:المكون DatePickerAndroid في React Native}}</noinclude>
<blockquote>'''مهملة''': استعمل إحدى [https://reactnative.directory/?search=datepicker الحزم من المجتمع] بدلًا عنها.</blockquote>تُستخدم <code>DatePickerAndroid</code> لإظهار مُنتقي التّاريخ (date picker) المعياريّ على منصّة Android.
__toc__
== مثال ==
<syntaxhighlight lang="javascript">
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);
} 
</syntaxhighlight>

== التوابع ==

=== <code>‎open()‎</code> ===
<syntaxhighlight lang="javascript">
static open(options)
</syntaxhighlight>يفتح مربع حوار منتقي التّاريخ المعياري لمنصّة Android.

المفاتيح المتاحة للكائن <code>options</code>:

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

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

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

=== <code>‎dataSetAction()‎</code> ===
<syntaxhighlight lang="javascript">
static dateSetAction()
</syntaxhighlight>اختير تاريخ.

=== <code>dismissedAction()‎</code> ===
<syntaxhighlight lang="javascript">
static dismissedAction()
</syntaxhighlight>رُفض مربع حوار منتقي التّاريخ.

== مصادر ==

* [https://facebook.github.io/react-native/docs/datepickerandroid صفحة DatePickerAndroid في توثيق React Native الرسميّ]
[[تصنيف:ReactNative]]
[[تصنيف:React Native Component]]