Clipboard
Dimensions

React Native中文文档0.51版

本组件会打开一个标准的Android日期选择器的对话框。

示例

try {
  const {action, year, month, day} = await DatePickerAndroid.open({
    // 要设置默认值为今天的话，使用`new Date()`即可。
    // 下面显示的会是2020年5月25日。月份是从0开始算的。
    date: new Date(2020, 4, 25)
  });
  if (action !== DatePickerAndroid.dismissedAction) {
    // 这里开始可以处理用户选好的年月日三个参数：year, month (0-11), day
  }
} catch ({code, message}) {
  console.warn('Cannot open date picker', message);
}

方法

static open(options: Object) #

打开一个标准的Android日期选择器的对话框。

可选的options对象的key值如下：

  • date (Date对象或毫秒时间戳) - 默认显示的日期
  • minDate (Date对象或毫秒时间戳) - 可选的最小日期
  • maxDate (Date对象或毫秒时间戳) - 可选的最大日期
  • mode ((enum('calendar', 'spinner', 'default')) - 设置选择器的模式：
    • calendar: Show a date picker in calendar mode.
    • spinner: Show a date picker in spinner mode.
    • default: Show a default native date picker(spinner/calendar) based on android versions.

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

static dateSetAction() #

已选中一个日期。

static dismissedAction() #

取消对话框。

书籍推荐