rc-datetime-picker

Rc-Datetime-Picker

Rc-Datetime-Picker is a react component for datetime picker by Moment.js.

Requirements

• React
• Moment.js
• Modern browsers (IE>=9 is required)

Installation

Install with NPM

$ npm install rc-datetime-picker

Manual download

Besides npm package, UMD module is placed under dist/ directory:

• dist/rc-datetime-picker.js
• dist/rc-datetime-picker.min.js

Usage

See the demo page.

Props

DatetimePicker Props

Name	Type	Default	Description
moment	moment		Set the selected date.
onChange	Function(datetime: moment)		`onChange` will be triggered while datetime changing.
className	String		Additional css class of root dom node.
isOpen	Boolean	true	Whether to show the picker.
showCalendarPicker	Boolean	true	Whether to show the calendar picker.
showTimePicker	Boolean	true	Whether to show the time picker.
splitPanel	Boolean	false	Enable `split-panel` mode.
shortcuts	Object:{name: value}		Add shortcuts on the top `shortcuts-bar` for selecting a date.
maxDate	moment		Max Date limit.
minDate	moment		Min Date limit.
weeks	Array	['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']	Text for weekdays.
months	Array	[Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']	Text for months.
dayFormat	String	'MMMM, YYYY'	Formatting current date of the day panel.
minPanel	String	'day'	Min panel for select.

DatetimePickerTrigger Props

Name	Type	Default	Description
moment	moment		Set the selected date.
onChange	Function(datetime: moment)		`onChange` will be triggered while datetime changing.
className	String		Additional css class of root dom node.
showCalendarPicker	Boolean	true	Whether to show the calendar picker.
showTimePicker	Boolean	true	Whether to show the time picker.
splitPanel	Boolean	false	Enable `split-panel` mode.
shortcuts	Object:{name: value}		Add shortcuts on the top `shortcuts-bar` for selecting a date.
maxDate	moment		Max Date limit.
minDate	moment		Min Date limit.
weeks	Array	['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']	Text for weekdays.
months	Array	[Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']	Text for months.
dayFormat	String	'MMMM, YYYY'	Formatting current date of the day panel.
appendToBody	Boolean	false	Whether to render the picker to `body`.
closeOnSelectDay	Boolean	false	Whether to close the picker when selecting a date on day panel.
disabled	Boolean	false	Disabled triggering.
minPanel	String	'day'	Min panel for select.

DatetimeRangePicker Props

Name	Type	Default	Description
moment	Object: {start: moment, end: moment}		Set the selected date range.
onChange	Function(datetime: {start: moment, end: moment})		`onChange` will be triggered while confirm button or shortcuts clicked.
className	String		Additional css class of root dom node.
showCalendarPicker	Boolean	true	Whether to show the calendar picker.
showTimePicker	Boolean	false	Whether to show the time picker.
splitPanel	Boolean	false	Enable `split-panel` mode.
shortcuts	Object:{name: {start: moment, end: moment}}		Add shortcuts on the top `shortcuts-bar` for selecting a date range.
maxDate	moment		Max Date limit.
minDate	moment		Min Date limit.
weeks	Array	['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']	Text for weekdays.
months	Array	[Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']	Text for months.
dayFormat	String	'MMMM, YYYY'	Formatting current date of the day panel.
format	String	'YYYY/MM/DD HH:mm' / 'YYYY/MM/DD'	Formatting current date of each panel.
showCustomButton	Boolean	false	Whether to show the custom button.
customButtonText	String	Custom	Text for custom button.
customRange	Object: {start: moment, end: moment}	Last 30 days	Set the custom button value.
confirmButtonText	String	Confirm	Text for confirm button.
startDateText	String	Start Date:	Text for start date label.
endDateText	String	End date:	Text for end date label.
dateLimit	Object: {name: value}		Date range limt.
minPanel	String	'day'	Min panel for select.

DatetimeRangePickerTrigger Props

Name	Type	Default	Description
moment	Object: {start: moment, end: moment}		Set the selected date range.
onChange	Function(datetime: {start: moment, end: moment})		`onChange` will be triggered while confirm button or shortcuts clicked.
className	String		Additional css class of root dom node.
showCalendarPicker	Boolean	true	Whether to show the calendar picker.
showTimePicker	Boolean	false	Whether to show the time picker.
splitPanel	Boolean	false	Enable `split-panel` mode.
shortcuts	Object:{name: {start: moment, end: moment}}		Add shortcuts on the top `shortcuts-bar` for selecting a date range.
maxDate	moment		Max Date limit.
minDate	moment		Min Date limit.
weeks	Array	['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']	Text for weekdays.
months	Array	[Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']	Text for months.
dayFormat	String	'MMMM, YYYY'	Formatting current date of the day panel.
format	String	'YYYY/MM/DD HH:mm' / 'YYYY/MM/DD'	Formatting current date of each panel.
showCustomButton	Boolean	false	Whether to show the custom button.
customButtonText	String	Custom	Text for custom button.
customRange	Object: {start: moment, end: moment}	Last 30 days	Set the custom button value.
confirmButtonText	String	Confirm	Text for confirm button.
startDateText	String	Start Date:	Text for start date label.
endDateText	String	End date:	Text for end date label.
dateLimit	Object: {name: value}		Date range limt.
appendToBody	Boolean	false	Whether to render the picker to `body`.
disabled	Boolean	false	Disabled triggering.
minPanel	String	'day'	Min panel for select.