عرض مصدر ReactNative/timepickerandroid

<noinclude>{{DISPLAYTITLE:الواجهة TimePickerAndroid في React Native}}</noinclude>
<blockquote>'''مهملة:''' استخدم إحدى [https://reactnative.directory/?search=timepicker الحزم من المجتمع] بدلًا منها.</blockquote>تفتح صندوق حوار مُنتقي الوقت (time picker) المعياريّ لمنصة Android.
__toc__
== مثال ==
<syntaxhighlight lang="javascript">
try {
  const { action, hour, minute } = await TimePickerAndroid.open({
    hour: 14,
    minute: 0,
    is24Hour: false // Will display '2 PM'
  });
  if (action !== TimePickerAndroid.dismissedAction) {
    // Selected hour (0-23), minute (0-59)
  }
} catch ({ code, message }) {
  console.warn('Cannot open time picker', message);
}
</syntaxhighlight>

== التوابع ==

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

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

* <code>hour</code> السّاعة: 0 - 23  إظهار السّاعة، افتراضيًّا الساعة الحاليّة.
* <code>minute</code> الدّقائق: 0 - 59 إظهار الدّقيقة، افتراضيّا الدّقيقة الحاليّة.
* ‎<code>is24Hour</code>: قيمةٌ منطقيّةٌ (boolean) تُظهر الوقت بنظام 24 ساعة، إن كانت قيمتها <code>true</code>، وبنظام 12 ساعة، وإذا كانت قيمتها <code>false</code>، يظهرها المنتقي على شكل اختيار AM/PM. وإذا لم تعرّف يعتمد نظام التوقيت المحلّي.
* <code>mode (enum('clock', 'spinner', 'default'))‎</code>:  تحديد وضع منتقي الوقت:
** <code>'clock'</code>: إظهار مُنتقي الوقت بوضع الساعة (clock)
** <code>'spinner'</code>: إظهار مُنتقي الوقت بالوضع الدوار (spinner)
** <code>'default'</code>: إظهار مُنتقي الوقت الافتراضي اعتمادًا على إصدار Android

يُعيد هذا التابع وعدًا (Promise)، والذي سيقبل إلى كائن يحوي المفاتيح <code>action</code>، و<code>hour</code>، و<code>minute</code>، إذا اختار المستخدم الوقت. أما إذا رفض المستخدم  (dismiss) مربع الحوار فسيجعل الوعد  قيمة المفتاح <code>action</code> مساوية <code>TimePickerAndroid.dismissedAction</code>؛ أما باقي المفاتيح، فلن تعرَّف، وسيتم  دائما  تفحص <code>action</code> قبل قراءة القيم.

=== <code>timeSetAction()‎</code> ===
<syntaxhighlight lang="javascript">
static timeSetAction()
</syntaxhighlight>وتعني أنّه قد تمّ اختيار وقت.

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

== مصادر ==

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