Accessible, customizable, delightful date & time pickers for @material-ui/core
Please read the migration guide if you are updating from v2
// via npm
npm i @material-ui/pickers
// via yarn
yarn add @material-ui/pickers
Old versions documentation:
Version | Documentation url |
---|---|
Stable v2 | https://material-ui-pickers-v2.dmtr-kovalenko.now.sh/ |
Alpha v3 | https://material-ui-pickers-v3.dmtr-kovalenko.now.sh/ |
Now choose the library that pickers will use to work with date. We are providing interfaces for moment, luxon, dayjs and date-fns v2. If you are not using moment in the project (or dont have it in the bundle already) we suggest using date-fns or luxon, because they are much lighter and will be correctly tree-shaked from the bundle. Note, that we are fully relying on date-io for supporting different libraries.
npm i date-fns@next @date-io/date-fns
// or
npm i moment @date-io/moment
// or
npm i luxon @date-io/luxon
// or
npm i dayjs @date-io/dayjs
Then teach pickers which library to use with MuiPickerUtilsProvider
. This component takes a utils property, and makes it available down the React tree thanks to React context. It should preferably be used at the root of your component tree.
import MomentUtils from '@date-io/moment';
import DateFnsUtils from '@date-io/date-fns';
import LuxonUtils from '@date-io/luxon';
import { MuiPickersUtilsProvider } from '@material-ui/pickers';
function App() {
return (
<MuiPickersUtilsProvider utils={DateFnsUtils}>
<Root />
</MuiPickersUtilsProvider>
);
}
render(<App />, document.querySelector('#app'));
Check out the documentation website
Changelog available here
For information about how to contribute, see the CONTRIBUTING file.
The project is licensed under the terms of MIT license