NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4185 most downloaded on npm
A simple and reusable datepicker component for React
Last release 9 months ago
19 Dec 2025
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
202 releases · first in 2014
This release includes important bug fixes, TypeScript improvements, and a new feature. Most notably, it restores date parsing behavior that was accide
This release includes important bug fixes, TypeScript improvements, and a new feature. Most notably, it restores date parsing behavior that was accidentally removed in v8.0.0.
Allow onClickOutside to prevent calendar from closing (#6179)
The onClickOutside callback can now prevent the calendar from closing by calling event.preventDefault(). This is useful when using custom portal-based dropdowns in the calendar header.
<DatePicker
onClickOutside={(event) => {
if (myPortalRef.current?.contains(event.target)) {
event.preventDefault(); // Keeps calendar open
}
}}
/>
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v9.0.0...v9.1.0
One column per quarter.
The most requested feature is here! Add the timeZone prop to display and handle dates in any timezone. Works with date-fns-tz as an optional peer depe
The most requested feature is here! Add the timeZone prop to display and handle dates in any timezone. Works with date-fns-tz as an optional peer dependency. <DatePicker timeZone="America/New_York" />
showTimeSelect and showTimeInput now work beautifully with selectsRange! Select time for both start and end dates independently. 🎉
popperTargetRef - Custom popper positioning for advanced layoutsmonthHeaderPosition - Control month header placement (top, middle, bottom)renderCustomDayName - Customize weekday header renderingformatMultipleDates - Custom formatting for multi-select datesaria-label - Better accessibility support💫 Happy Holidays!
Thank you to all contributors who made this release possible! May your dates always be in the right timezone! 🎅🎄
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.10.0...v9.0.0
Enhance the readability of doc-sites examples by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/6040
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.9.0...v8.10.0
🎨♿ Fix keyboard-selected + hovered date text color for accessibility by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5955
CalendarComponent component with correct accessibility attrs by @ilchenkoArtem in https://github.com/Hacker0x01/react-datepicker/pull/6008Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.8.0...v8.9.0
✨ docs-site(ts): Migrate examples to TypeScript, add live transpilation to JavaScript + Copy code feature by @balajis-qb in https://github.com/Hacker0
selectionMeta param to the onChangeRaw event call - to give additional details about the selected date by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5858Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.7.0...v8.8.0
Add jest-axe Accessibility Testing and Fix ARIA Structure Issues by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/5808
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.6.0...v8.7.0
Fix React 19 compatibility issues with @floating-ui/react by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/5787
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.5.0...v8.6.0
✏️ Renamed the startDate variable in the example code to the selectedDate to improve clarity and better reflect it's purpose by @balajis-qb in https:/
startDate variable in the example code to the selectedDate to improve clarity and better reflect it's purpose by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5501visibleYearsRange in the renderCustomHeader of the YearPicker by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5687Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.4.0...v8.5.0
Fix readOnly prop for a clearButton and inline calendare by @SergeyKazarinov in https://github.com/Hacker0x01/react-datepicker/pull/5564
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.3.0...v8.4.0
🐛🎨 Apply the --selected class for the YearPicker when the selectsMultiple is enabled by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/
--selected class for the YearPicker when the selectsMultiple is enabled by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5524Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.2.1...v8.3.0
Remove console.log from deferBlur by @ryangreenberg in https://github.com/Hacker0x01/react-datepicker/pull/5482
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.2.0...v8.2.1
🔧 Update the production build script config to include cssprod by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5436
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.1.0...v8.2.0
Fix #5274: 🐛 Auto refresh the input value with the previously entered valid value if any invalid value is entered (when the open state is closed) by @
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v8.0.0...v8.1.0
Fix deprecation warning hljs by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/5329
parseDate by @laug in https://github.com/Hacker0x01/react-datepicker/pull/5036Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.6.0...v8.0.0
🐛 Fix #5084: Fixfox Tab switch issue by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/5179
PropsWithChildren type argument issue by @mertJF in https://github.com/Hacker0x01/react-datepicker/pull/5223PropsWithChildren type argument issue by @mertJF in https://github.com/Hacker0x01/react-datepicker/pull/5236Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.5.0...v7.6.0
Fix #5137: 🧪✅ Fix the accidental change of the complete month issue with the test cases by selecting to a earlier date in a month by @balajis-qb in ht
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.4.0...v7.5.0
Remove usages of react-onclickoutside to support React 19 by @hamidrezahanafi in https://github.com/Hacker0x01/react-datepicker/pull/4979
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.3.0...v7.4.0
Add multiple months visual selection by @luistorres in https://github.com/Hacker0x01/react-datepicker/pull/4944
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.2.0...v7.3.0
feat: export CalendarContainerProps interface by @plahteenlahti in https://github.com/Hacker0x01/react-datepicker/pull/4914
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.1.0...v7.2.0
Fix #4902: 🐛 Fix the click of week numbers when the first day of the week is not enabled by @balajis-qb in https://github.com/Hacker0x01/react-datepic
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v7.0.0...v7.1.0
We've done our best to document the breaking changes:
This release includes a Typescript migration. This has been a big overhaul of the code base. This is the biggest release ever with 447 commits and 104 files changed! Massive thanks to @mirus-ua, @yuki0410-dev, @Olenka-Yurchuk, @alvaromartinez986, and @ryantanrk. We've done our best to document the breaking changes:
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.9.0...v7.0.0
Use locale for month aria labels by @lasseklovstad in https://github.com/Hacker0x01/react-datepicker/pull/4697
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.8.0...v6.9.0
fix: #4400 Keyboard accessibility MonthYearPicker by @lasseklovstad in https://github.com/Hacker0x01/react-datepicker/pull/4692
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.7.1...v6.8.0
fix: popper dosen't close if swapRange prop was passed by @mirus-ua in https://github.com/Hacker0x01/react-datepicker/pull/4689
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.7.0...v6.7.1
Fix #4644: Handle the visibility of the previous and the next year navigation when showQuarterYearPicker is enabled by @balajis-qb in https://github.c
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.6.0...v6.7.0
feat: #3798 Replaced classnames with clsx by @yuki0410-dev in https://github.com/Hacker0x01/react-datepicker/pull/4632
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.5.0...v6.6.0
fix: #4489 Disable weekNumber highlighting when no click handler is assigned. by @yuki0410-dev in https://github.com/Hacker0x01/react-datepicker/pull/
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.4.0...v6.5.0
chore(deps): bump date-fns from 3.4.0 to 3.5.0 by @dependabot in https://github.com/Hacker0x01/react-datepicker/pull/4599
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.3.0...v6.4.0
Fix #4518: 🔨 Add accessibility props like role and aria-modal to the Calendar popup by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/p
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.2.0...v6.3.0
fix:enhance-code-syntax by @mary139 in https://github.com/Hacker0x01/react-datepicker/pull/4505
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.1.0...v6.2.0
Fix - Removed defaultProps from Function Components for React 18.3. by @shyk001 in https://github.com/Hacker0x01/react-datepicker/pull/4498
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v6.0.0...v6.1.0
Upgrade date-fns to v3 by @ethanve in https://github.com/Hacker0x01/react-datepicker/pull/4481
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v5.1.0...v6.0.0
Fix options passed to date-fns/parse by @emilecantin in https://github.com/Hacker0x01/react-datepicker/pull/4474
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v5.0.0...v5.1.0
Migrate from Popper.js to Floating-UI by @G07cha in https://github.com/Hacker0x01/react-datepicker/pull/4393
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.25.0...v5.0.0
feature: Add day parameter to renderMonthContent function by @omarhoumz in https://github.com/Hacker0x01/react-datepicker/pull/4405
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.24.0...v4.25.0
containerRef div shouldnt affect styling by @joaopaulo-capy in https://github.com/Hacker0x01/react-datepicker/pull/4384
holidays prop change by @shimech in https://github.com/Hacker0x01/react-datepicker/pull/4373Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.23.0...v4.24.0
Fix #4334: Improved Test Cases Readability and Maintainability by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/4335
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.21.0...v4.23.0
Update usage of findDOMNode by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/4190
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.20.0...v4.21.0
Fix: Display Issue of Calendar Icon in React Date Picker (#4291) by @frankops11 in https://github.com/Hacker0x01/react-datepicker/pull/4298
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.19.0...v4.20.0
Fix #4283: Ensure Proper Date Selection in DatePicker Test Case by @balajis-qb in https://github.com/Hacker0x01/react-datepicker/pull/4284
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.18.0...v4.19.0
Improve focus with portals by @Sam-Apostel in https://github.com/Hacker0x01/react-datepicker/pull/4245
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.17.0...v4.18.0
check if deploy works on node 18 by @Zarthus in https://github.com/Hacker0x01/react-datepicker/pull/4152
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.16.0...v4.17.0
Prop className did not match by @pymc20 in https://github.com/Hacker0x01/react-datepicker/pull/4126
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.15.0...v4.16.0
[FIX][Month picker] Selected month follows preselected month by @KevinFabre-ods in https://github.com/Hacker0x01/react-datepicker/pull/4090
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.14.1...v4.15.0
Revert "fix: Uneven margin in inline calendar" by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/4085
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.14.0...v4.14.1
Fix typos in test by @ansgarprause in https://github.com/Hacker0x01/react-datepicker/pull/4077
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.13.0...v4.14.0
[FIX][A11Y] Inescapable tabbing on month by @KevinFabre-ods in https://github.com/Hacker0x01/react-datepicker/pull/4049
rem units with em units" by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/4058Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.12.0...v4.13.0
Fix range selection highlight for month/quarter range picker by @p-rogas in https://github.com/Hacker0x01/react-datepicker/pull/3968
rem units with em units by @Ugoku in https://github.com/Hacker0x01/react-datepicker/pull/3998Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.11.0...v4.12.0
chore(deps): bump react-datepicker from 4.9.0 to 4.10.0 in /examples/hello-world by @dependabot in https://github.com/Hacker0x01/react-datepicker/pull
parseDate " by @martijnrusschen in https://github.com/Hacker0x01/react-datepicker/pull/3976Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.10.0...v4.11.0
chore(deps): bump react-datepicker from 4.9.0 to 4.10.0 in /examples/hello-world by @dependabot in https://github.com/Hacker0x01/react-datepicker/pull
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.10.0...v4.10.1
Fix: Screen reader does not announce selected date, current month by @SpaNb4 in https://github.com/Hacker0x01/react-datepicker/pull/3817
Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.9.0...v4.10.0
Fix class not applied on day component for datepicker with selectsRange prop by @c-falardeau in https://github.com/Hacker0x01/react-datepicker/pull/35
selectsRange prop by @c-falardeau in https://github.com/Hacker0x01/react-datepicker/pull/3595react-onclickoutside to 6.12.1 by @patrykboch in https://github.com/Hacker0x01/react-datepicker/pull/3653parseDate by @maranomynet in https://github.com/Hacker0x01/react-datepicker/pull/3903form - input form attribute by @Sam-Apostel in https://github.com/Hacker0x01/react-datepicker/pull/3896Full Changelog: https://github.com/Hacker0x01/react-datepicker/compare/v4.8.0...v4.9.0
Enable specifying aria-label prefix for month
Fix accessibility issues of calendar
Fix year dropdown scroll on open
Fix: month text today not displayed
Fix isValid helper so it accepts dates equal to minDate
Bump date-fns to non-breaking release 2.24.0
Fix CSS compilation issue with libsass
Fix CSS compilation issue with libsass
fix next/prev arrow onkeydown handlers
Your coding agent can read these notes before it upgrades. Set up the MCP server →