NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4112 most downloaded on npm
The community edition of the MUI X Date and Time Picker components.
Latest stable
9.17.0
Last release 23 days ago
30 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
279 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
We'd like to offer a big thanks to the 8 contributors who made this release possible. Here are some highlights ✨:
@mui/x-data-grid@v6.0.0-alpha.1 / @mui/x-data-grid-pro@v6.0.0-alpha.1 / @mui/x-data-grid-premium@v6.0.0-alpha.1New internal rows structure for v6 (#4927) @flaviendelangle
Some selectors related to the rows have been renamed to better describe the type of rows they are returning:
-const result = gridRowsIdToIdLookupSelector(apiRef);
+const result = gridRowsDataRowIdToIdLookupSelector(apiRef);
-const result = gridRowTreeDepthSelector(apiRef);
+const result = gridRowMaximumTreeDepthSelector(apiRef);
The format of the tree nodes (the element accessible in params.node or with the apiRef.current.getRowNode method) have changed.
You have a new type property, which can be useful, for example, to apply custom behavior on groups.
Here is an example of the old and new approach showing how to apply a custom value formatter in groups for the grouping column:
<DataGridPremium
groupingColDef={() => ({
valueFormatter: (params) => {
if (params.id == null) {
return params.value;
}
const rowNode = apiRef.current.getRowNode(params.id!)!;
- if (rowNode.children?.length) {
+ if (rowNode.type === 'group') {
return `by ${rowNode.groupingKey ?? ''}`;
}
return params.value;
}
})}
/>
The GridFeatureModeConstant constant no longer exists (#6077) @DanailH
-import { GridFeatureModeConstant } from '@mui/x-data-grid';
GridPagination props typing (#6238) @cherniavskiiGridRow not forwarding ref to the root element (#6274) @cherniavskiiundefined value being showed in filter button tooltip text (#6259) @cherniavskiiprocessRowUpdate fails (#6185) @m4theushwthemeAugmentation module (#6270) @cherniavskii@mui/x-date-pickers@v6.0.0-alpha.1 / @mui/x-date-pickers-pro@v6.0.0-alpha.1[pickers] Do not support unparsed date formats anymore (#6170) @flaviendelangle
The value prop of the pickers now expects a parsed value.
Until now, it was possible to provide any format that your date management library was able to parse.
For instance, you could pass value={new Date()} when using AdapterDayjs.
This brought a lot of confusion so we decided to remove this behavior.
The format expected by the value prop is now the same as for any other prop holding a date.
Here is the syntax to initialize a date picker at the current date for each adapter:
// Date-fns
<DatePicker value={new Date()} />
// Dayjs
import dayjs from 'dayjs'
<DatePicker value={dayjs()} />
// Moment
import moment from 'moment'
<DatePicker value={moment()} />
// Luxon
import { DateTime } from 'luxon'
<DatePicker value={DateTime.now()} />
minDate and maxDate when opening a DatePicker or DateTimePicker (#6309) @alexfauquetteshouldDisableMonth and shouldDisableYear (#6266) @flaviendelangledisablePast and disableFuture validation props (#6226) @LukasTyautoFocus=false (#6304) @alexfauquetteexpandFormat and formatTokenMap (#6215) @alexfauquetteDateField component (#6048) @flaviendelangleAdapterLuxon (#6069) @alexfauquetteTimeField and DateTimeField (#6312) @flaviendelanglenext branch (#6275) @oliviertassinariuseField (#6311) @flaviendelangleGridFeatureModeConstant (#6077) @DanailHYour coding agent can read these notes before it upgrades. Set up the MCP server →
The deprecated hide column property has been removed in favor of the columnVisibilityModel prop and initial state. (#5999) @flaviendelangle
We'd like to offer a big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
localeText prop to all pickers to customize the translations (#6212) @flaviendelangle@mui/x-data-grid@v6.0.0-alpha.0 / @mui/x-data-grid-pro@v6.0.0-alpha.0 / @mui/x-data-grid-premium@v6.0.0-alpha.0The deprecated hide column property has been removed in favor of the columnVisibilityModel prop and initial state. (#5999) @flaviendelangle
<DataGrid
columns={[
field: 'id,
- hide: true,
]}
+ initialState={{
+ columns: {
+ columnVisibilityModel: { id: false },
+ }
+ }}
/>
You can find more information about this new API on our documentation.
The GridEvents enum is now a TypeScript type. (#6003) @flaviendelangle
-apiRef.current.subscribeEvent(GridEvents.rowClick', handleRowClick)
+apiRef.current.subscribeEvent('rowClick', handleRowClick)
cellFocusOut event if the row was removed (#6251) @cherniavskiiGridEvents enum (#6003) @flaviendelanglehide column property (#5999) @flaviendelangle@mui/x-date-pickers@v6.0.0-alpha.0 / @mui/x-date-pickers-pro@v6.0.0-alpha.0All the deprecated props that allowed you to set the text displayed in the pickers have been removed.
You can now use the localText prop available on all picker components:
| Removed prop | Property in the new localText prop |
|---|---|
endText |
end |
getClockLabelText |
clockLabelText |
getHoursClockNumberText |
hoursClockNumberText |
getMinutesClockNumberText |
minutesClockNumberText |
getSecondsClockNumberText |
secondsClockNumberText |
getViewSwitchingButtonText |
calendarViewSwitchingButtonAriaLabel |
leftArrowButtonText |
openPreviousView (or previousMonth when the button changes the visible month) |
rightArrowButtonText |
openNextView (or nextMonth when the button changes the visible month) |
startText |
start |
For instance if you want to replace the startText / endText
<DateRangePicker
- startText="From"
- endText="To"
+ localeText={{
+ start: 'From',
+ end: 'To',
+ }}
/>
You can find more information about the new api, including how to set those translations on all your components at once in the documentation
The component slots LeftArrowButton and RightArrowButton have been renamed PreviousIconButton and NextIconButton to better describe there usage:
<DatePicker
components={{
- LeftArrowButton: CustomButton,
+ PreviousIconButton: CustomButton,
- RightArrowButton: CustomButton,
+ NextIconButton: CustomButton,
}}
componentsProps={{
- leftArrowButton: {},
+ previousIconButton: {},
- rightArrowButton: {},
+ nextIconButton: {},
}}
/>
The date prop has been renamed value on MonthPicker / YearPicker, ClockPicker and CalendarPicker.
- <MonthPicker date={dayjs()} onChange={handleMonthChange} />
+ <MonthPicker value={dayjs()} onChange={handleMonthChange} />
- <YearPicker date={dayjs()} onChange={handleYearChange} />
+ <YearPicker value={dayjs()} onChange={handleYearChange} />
- <ClockPicker date={dayjs()} onChange={handleTimeChange} />
+ <ClockPicker value={dayjs()} onChange={handleTimeChange} />
- <CalendarPicker date={dayjs()} onChange={handleDateChange} />
+ <CalendarPicker value={dayjs()} onChange={handleDateChange} />
props.date contains a disabled date (#6146) @flaviendelanglelocaleText prop to all pickers to customize the translations (#6212) @flaviendelangleLocalizationProvider (#6011) @flaviendelanglePickersArrowSwitcher component (#5890) @flaviendelangleDateField day (#6071) @alexfauquettevalueStr from the field state (#6142) @flaviendelangledate prop value on MonthPicker / YearPicker, ClockPicker and CalendarPicker (#6128) @flaviendelangleonClose prop of PickersPopper onDismiss to simplify typing (#6155) @flaviendelanglesx prop on all public component with a root HTML elements (#5944) @flaviendelanglePickersMonth and PickersYear behaviors (#6034) @flaviendelangleshouldDisableMonth and shouldDisableYear for date validation (#6066) @flaviendelangleautoFocus=false (#6224) @alexfauquettepackage.json (#6172) @oliviertassinarigenerateUtilityClass from @mui/utils (#6216) @michaldudakv5.17.3 changelog to next branch (#6250) @flaviendelangleREADME (#6073) @oliviertassinarinext in NPM (#6256) @m4theushwnext branch for Prettier (#6097) @flaviendelangle@mui/monorepo instead of a fork (#6189) @oliviertassinariNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.