Material-UI pickers
Accessible, customizable, delightful date & time pickers for @material-ui/core
Installation
Note that this package reqiures @material-ui/core
v4. It will not work with the old v3. 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
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'));
Documentation
Check out the documentation website
Old versions documentation:
Version | Documentation url |
---|---|
v2 | https://material-ui-pickers-v2.dmtr-kovalenko.now.sh/ |
Recently updated?
Changelog available here
Contributing
For information about how to contribute, see the CONTRIBUTING file.
LICENSE
The project is licensed under the terms of MIT license