react-datetime

A date and time picker in the same React.js component. It can be used as a datepicker, timepicker or both at the same time.

It allows to edit even date's milliseconds.

This project started as a fork of https://github.com/quri/react-bootstrap-datetimepicker but the code and the API has changed a lot.

Usage

Installation :
npm install react-datetime

Then
```javascript
require('react-datetime');

...

render: function() {
return ;
}
```
See this example working.

API

i18n

Different language and date formats are supported by react-datetime. React uses moment.js to format the dates, and the easiest way of changing the language of the calendar is changing the moment.js locale.

var moment = require('moment');
require('moment/locale/fr');
// Now react-datetime will be in french

If there are multiple locales loaded, you can use the prop locale to define what language should be used by the instance:
js <Datetime locale="fr-ca" /> <Datetime locale="de" />
Here you can see the i18n example working.

Appearance customization

It is possible to customize the way that the datetime picker display the days, months and years in the calendar. To adapt the calendar to every need it is possible to use the props renderDay( props, currentDate, selectedDate ), renderMonth( props, month, year, selectedDate ) and renderYear( props, year, selectedDate ) of react-datetime.

var MyDTPicker = React.createClass({
    render: function(){
        return <Datetime
            renderDay={ this.renderDay } 
            renderMonth={ this.renderMonth } 
            renderYear={ this.renderYear }
        />;
    },
    renderDay: function( props, currentDate, selectedDate ){
        return <td {...props}>{ '0' + currentDate.date() }</td>;
    },
    renderMonth: function( props, month, year, selectedDate){
        return <td {...props}>{ month }</td>;
    },
    renderYear: function( props, year, selectedDate ){
        return <td {...props}>{ year % 100 }</td>;
    }
});

You can see this customized calendar here.

• props is the object that react-date picker has calculated for this object. It is convenient to use this object as the props for your custom component, since it knows how to handle the click event and its className attribute is used by the default styles.
• selectedDate and currentDate are Moment.js objects and can be used to change the output depending on the selected date, or the date for the current day.
• month and year are the numeric representation of the current month and year to be displayed. Notice that the possible month values go from 0 to 11.

Selectable dates

It is possible to disable dates in the calendar if we don't want the user to select them. It is possible thanks to the prop isValidDate, which admits a function in the form function( currentDate, selectedDate ) where both arguments are moment.js objects. The function should return true for selectable dates, and false for disabled ones.

If we want to disable all the dates before today we can do like
js // Let's use moment static reference in the Datetime component. var yesterday = Datetime.moment().subtract(1,'day'); var valid = function( current ){ return current.isAfter( yesterday ); }; <Datetime isValidDate={ valid } />
See the isValidDate prop working here.

If we want to disable the weekends
js var valid = function( current ){ return current.day() != 0 && current.day() != 6; }; <Datetime isValidDate={ valid } />
The example working here.

Contributions

Any help is always welcome :)

Changelog

MIT Licensed