DatePickerAndroid

本组件会打开一个标准的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() #

取消对话框。