DatePicker 日期选择
用于选择日期或者时间。
规则
- 最多展示 5 个独立滚轮,每个滚轮表示一个不同的值。
代码演示
基本
日期时间选择示例 (rc-form 文档)
import { DatePicker, List, Button } from 'antd-mobile';
import { createForm } from 'rc-form';
import moment from 'moment';
import 'moment/locale/zh-cn';
import enUs from 'antd-mobile/lib/date-picker/locale/en_US';
const zhNow = moment().locale('zh-cn').utcOffset(8);
const maxDate = moment('2018-12-03 +0800', 'YYYY-MM-DD Z').utcOffset(8);
const minDate = moment('2015-08-06 +0800', 'YYYY-MM-DD Z').utcOffset(8);
const maxTime = moment('22:00 +0800', 'HH:mm Z').utcOffset(8);
const minTime = moment('00:30 +0800', 'HH:mm Z').utcOffset(8);
const gmtNow = moment().utcOffset(0);
// 如果不是使用 List.Item 作为 children
const CustomChildren = (props) => (
<div
onClick={props.onClick}
style={{ backgroundColor: '#fff', height: '0.9rem', lineHeight: '0.9rem', padding: '0 0.3rem' }}
>
{props.children}
<span style={{ float: 'right' }}>{props.extra}</span>
</div>
);
let Test = React.createClass({
getInitialState() {
return {
date: zhNow,
dpValue: null,
visible: false,
};
},
onChange(date) {
// console.log('onChange', date);
this.setState({
date,
});
},
render() {
const { getFieldProps } = this.props.form;
return (<div>
<List
className="date-picker-list"
renderHeader={() => '选择时间'}
style={{ backgroundColor: 'white' }}
>
<DatePicker
mode="date"
title="选择日期"
extra="可选,小于结束日期"
{...getFieldProps('date1', {
initialValue: zhNow,
})}
minDate={minDate}
maxDate={maxDate}
>
<List.Item arrow="horizontal">日期</List.Item>
</DatePicker>
<DatePicker mode="time" {...getFieldProps('time1')}>
<List.Item arrow="horizontal">时间,不限定上下限</List.Item>
</DatePicker>
<DatePicker
mode="time"
{...getFieldProps('time', {
initialValue: zhNow,
})}
minDate={minTime}
maxDate={maxTime}
>
<List.Item arrow="horizontal">时间</List.Item>
</DatePicker>
<DatePicker className="forss"
mode="datetime"
onChange={this.onChange}
value={this.state.date}
>
<List.Item arrow="horizontal">日期+时间</List.Item>
</DatePicker>
<DatePicker
mode="time"
format={val => val.format('HH:mm Z')}
okText="Ok"
dismissText="Cancel"
locale={enUs}
{...getFieldProps('customformat', {
initialValue: gmtNow,
})}
>
<List.Item arrow="horizontal">time(en_US)</List.Item>
</DatePicker>
<List.Item extra={this.state.dpValue && this.state.dpValue.format()}>
<Button inline size="small" onClick={() => this.setState({ visible: true })}>自定义显示/隐藏</Button>
</List.Item>
</List>
<DatePicker
visible={this.state.visible}
mode="date"
title={<span onClick={() => this.setState({ visible: false })}>点击可以关闭</span>}
extra="请选择(可选)"
onOk={() => console.log('onOk')}
onDismiss={() => console.log('onDismiss')}
value={this.state.dpValue}
onChange={(v) => this.setState({ dpValue: v, visible: false })}
/>
<DatePicker
mode="date"
title="选择日期"
extra="请选择(可选)"
value={this.state.dpValue}
onChange={(v) => this.setState({ dpValue: v })}
>
<CustomChildren>时间选择(自定义 children)</CustomChildren>
</DatePicker>
</div>);
},
});
Test = createForm()(Test);
ReactDOM.render(<Test />, mountNode);
.date-picker-list .am-list-item .am-list-line .am-list-extra {
flex-basis: initial;
}
API ( 适用平台:WEB、React-Native )
成员 | 说明 | 类型 | 默认值 |
---|
mode | 日期选择的类型,可以是日期date 、时间time 、日期+时间datetime | String | date |
value | 当前选中时间,各种mode下格式分别为:YYYY-MM-DD 、HH:mm 、YYYY-MM-DD HH:mm | moment | 无 |
minDate | 最小可选日期,格式同 value | moment | - |
maxDate | 最大可选日期,格式同 value | moment | - |
onChange | 时间发生变化的回调函数 | (date: Object): void | 无 |
locale | 国际化配置 (可自行构造,结构为 {year, month, day, hour, minute}) | Object | DatePicker.locale.zh_CN |
okText | 选中的文案 | string/React.ReactElement | 确定 |
dismissText | 取消选中的文案 | string/React.ReactElement | 取消 |
title | 弹框的标题 | string/React.ReactElement | 无 |
format | 格式化选中的值 | (value:moment) => string/string | (val) => { return val; } |
extra | DatePicker children 建议是 List.Item, 如果不是,需要是自定义组件(组件内需处理onClick /extra 属性) | String | 请选择 |
更多参数及支持情况可参考:https://github.com/react-component/m-date-picker