/material-ui-pickers

Accessible, customizable, delightful date & time pickers for @material-ui/core

Primary LanguageJavaScriptMIT LicenseMIT

Material-UI logo

Material-UI pickers

Accessible, customizable, delightful date & time pickers for @material-ui/core

npm package npm download codecov Bundle Size Build Status code style: prettier

Installation

Available as npm package.

npm i material-ui-pickers

// or 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 and date-fns. 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 support only the 2.0.0-alpha.21 version of date-fns for now. Stay tuned!

npm i date-fns@2.0.0-alpha.21 @date-io/date-fns
// or
npm i moment @date-io/moment
// or
npm i luxon @date-io/luxon

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

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