timepickerandroid.md

id	title
timepickerandroid	🚧 TimePickerAndroid

已过时。 Use @react-native-community/datetimepicker instead.

本组件会打开一个标准的 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对象的 key 值如下：

• hour (0-23) - 要显示的小时，默认为当前时间。
• minute (0-59) - 要显示的分钟，默认为当前时间。
• is24Hour (boolean) - 如果设为true，则选择器会使用 24 小时制。如果设为false，则会额外显示 AM/PM 的选项。如果不设定，则采取当前地区的默认设置。
• mode (enum('clock', 'spinner', 'default')) - set the time picker mode
  • 'clock': Show a time picker in clock mode.
  • 'spinner': Show a time picker in spinner mode.
  • 'default': Show a default time picker based on Android versions.

在用户选好时间后返回一个 Promise，回调参数为一个对象，其中包含有action, hour (0-23), minute (0-59)。如果用户取消了对话框，Promise 仍然会执行，返回的 action 为TimePickerAndroid.dismissedAction，其他几项参数则为 undefined. 所以请在使用其他值之前务必先检查action的值。

---

timeSetAction()

static timeSetAction()

已选中一个时间。

---

dismissedAction()

static dismissedAction()

对话框被取消。