ReactNative/timepickerandroid

TimePickerAndroid

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

تفتح صندوق حوار مُنتقي الوقت (time picker) المعياريّ لمنصة Android.

مثال

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);
}

التوابع

open()‎

static open(options)

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

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

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

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

timeSetAction()‎

static timeSetAction()

تمّ اختيار وقت.

dismissedAction()‎

static dismissedAction()

رُفضَ صندوق حوار مُنقي الوقت.

مصادر

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