ant-design/components/date-picker/index.md

DatePicker

• category: Components
• chinese: 日期选择框
• type: 表单

---

输入或选择日期的控件。

何时使用

当用户需要输入一个日期，可以点击标准输入框，弹出日期面板进行选择。

API

DatePicker

<DatePicker defaultValue="2015-01-01" />

注意：0.11+ 后 Datepicker 改名为 DatePicker。

参数	说明	类型	默认值
value	日期	string or Date	无
defaultValue	默认日期	string or Date	无
format	展示的日期格式，配置参考 GregorianCalendarFormat	string	"yyyy-MM-dd"
disabledDate	不可选择的日期	function	无
onChange	时间发生变化的回调，发生在用户选择时间时	function(Date value)	无
disabled	禁用	bool	false
style	自定义输入框样式	object	{}
popupStyle	格外的弹出日历样式	object	{}
size	输入框大小，large 高度为 32px，small 为 22px，默认是 28px	string	无
locale	国际化配置	object	默认配置
showTime	增加时间选择功能	bool	false
onOk	点击确定按钮的回调	function(Date value)	无
getCalendarContainer	定义浮层的容器，默认为 body 上新建 div	function(trigger)	无

MonthPicker

参数	说明	类型	默认值
value	日期	string or Date	无
defaultValue	默认日期	string or Date	无
format	展示的日期格式，配置参考 GregorianCalendarFormat	string	"yyyy-MM"
onChange	时间发生变化的回调，发生在用户选择时间时	function(Date value)	无
disabled	禁用	bool	false
style	自定义输入框样式	object	{}
popupStyle	格外的弹出日历样式	object	{}
size	输入框大小，large 高度为 32px，small 为 22px，默认是 28px	string	无
locale	国际化配置	object	默认配置
getCalendarContainer	定义浮层的容器，默认为 body 上新建 div	function(trigger)	无

RangePicker

参数	说明	类型	默认值
value	日期	[string/Date, string/Date]	无
defaultValue	默认日期	[string/Date, string/Date]	无
format	展示的日期格式	string	"yyyy-MM-dd HH:mm:ss"
onChange	时间发生变化的回调，发生在用户选择时间时	function([Date start, Date end])	无

disabled style popupStyle size locale showTime onOk getCalendarContainer 属性与 DatePicker 的一致。