# react-dates/react-dates

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/react-dates-react-dates).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

12,159 stars · 1,661 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/react-dates/react-dates
- Homepage: https://react-dates.github.io/react-dates/
- awesome-repositories: https://awesome-repositories.com/repository/react-dates-react-dates.md

## Topics

`calendar` `datepicker` `dates` `react` `react-component` `react-dates`

## Description

react-dates is a set of React components for choosing dates. It covers single-date pickers and start/end date range pickers, each available as an input with a popup calendar or as an always-visible inline calendar. The host application owns the selected dates and focus state, and the components render them and report changes back through callbacks.

The calendars are themeable: colors and sizes come from one registered theme object, and the default CSS styling can be swapped for Aphrodite. Day-level rules let developers block, highlight, or limit days through predicate functions, minimum and maximum dates, and minimum-night requirements, which suits reservation and availability selection. Preset range shortcuts can be shown beside the calendar so users can fill in a start and end date with one click.

Dates, month names, and weekday names are formatted from Moment.js locale data, and every built-in label and screen-reader message sits in one replaceable phrases table for translation. The calendars support right-to-left layouts and keyboard-only selection. The picker also switches between a desktop popup and a full-screen mobile layout based on viewport size.

The library is built into separate CommonJS and ES module outputs, with prop-type checks stripped from production builds.

## Tags

### User Interface & Experience

- [Calendar Date Selection](https://awesome-repositories.com/f/user-interface-experience/calendar-date-selection.md) — Renders accessible calendar grids where users pick a single date or a date range, in popup or inline form. ([source](https://github.com/react-dates/react-dates/blob/master/package.json))
- [React Date Pickers](https://awesome-repositories.com/f/user-interface-experience/date-and-time-pickers/react-date-pickers.md) — Ships React components for choosing single dates or date ranges through inputs with popup calendars or always-visible inline calendars.
- [Popup Range Inputs](https://awesome-repositories.com/f/user-interface-experience/calendar-date-selection/popup-range-inputs.md) — Shows paired start and end inputs that open a popup calendar, with the host application managing the range and focused input. ([source](https://github.com/react-dates/react-dates/tree/master/examples))
- [Popup Single Date Inputs](https://awesome-repositories.com/f/user-interface-experience/calendar-date-selection/popup-single-date-inputs.md) — Pairs a single date input with a popup calendar, with the host application controlling the selected value and focus. ([source](https://github.com/react-dates/react-dates/tree/master/examples))
- [Start and End Date Ranges](https://awesome-repositories.com/f/user-interface-experience/date-and-time-pickers/react-date-pickers/start-and-end-date-ranges.md) — Offers start and end date inputs with a popup calendar for choosing a span of days, with dates and focus owned by the host application. ([source](https://github.com/react-dates/react-dates/tree/master/stories))
- [Predicate-Driven Day Rules](https://awesome-repositories.com/f/user-interface-experience/predicate-driven-day-rules.md) — Runs developer-supplied predicate functions for each rendered day to decide which days are blocked, highlighted, or out of range.
- [Booking Calendars](https://awesome-repositories.com/f/user-interface-experience/booking-calendars.md) — Blocks unavailable days and enforces minimum nights and date limits so visitors can only choose open reservation dates.
- [Inline Range Calendars](https://awesome-repositories.com/f/user-interface-experience/calendar-date-selection/inline-range-calendars.md) — Renders an always-visible input-free calendar where users pick a date range while the host application controls the selection and focus. ([source](https://github.com/react-dates/react-dates#readme))
- [Custom Color Theme Definitions](https://awesome-repositories.com/f/user-interface-experience/color-themes/custom-color-theme-definitions.md) — Overrides default theme values such as highlight colors so calendar days and other elements match an application's visual style. ([source](https://github.com/react-dates/react-dates#readme))
- [Localized Date Pickers](https://awesome-repositories.com/f/user-interface-experience/date-and-time-pickers/localized-date-pickers.md) — Supports Moment.js locale formatting, translated labels, right-to-left layouts, and keyboard and screen-reader friendly date selection.
- [Responsive Date Pickers](https://awesome-repositories.com/f/user-interface-experience/date-and-time-pickers/responsive-date-pickers.md) — Switches between a desktop popup and a full-screen mobile calendar layout based on viewport size.
- [Date Range Restrictions](https://awesome-repositories.com/f/user-interface-experience/date-range-schedulers/date-range-restrictions.md) — Restricts selectable days through minimum and maximum dates, minimum-night requirements, and predicate functions that block specific days. ([source](https://github.com/react-dates/react-dates#readme))
- [Quick-Select Date Ranges](https://awesome-repositories.com/f/user-interface-experience/date-range-schedulers/quick-select-date-ranges.md) — Shows one-click preset range shortcuts beside the calendar so users can fill start and end dates without clicking individual days. ([source](https://github.com/react-dates/react-dates/tree/master/stories))
- [Responsive Layout Switches](https://awesome-repositories.com/f/user-interface-experience/full-screen-viewport-layouts/responsive-layout-switches.md) — Switches between a desktop popup and a full-screen mobile calendar layout based on viewport size at render time.
- [Localized Calendar Labels](https://awesome-repositories.com/f/user-interface-experience/localized-calendar-labels.md) — Formats dates, month names, and weekday names from Moment.js locale data and lets applications replace every built-in label with translations.
- [Pluggable Styling Backends](https://awesome-repositories.com/f/user-interface-experience/pluggable-styling-backends.md) — Lets the default CSS styling be swapped for a CSS-in-JS alternative like Aphrodite so the calendar fits an existing styling setup.
- [Object-Based Theme Systems](https://awesome-repositories.com/f/user-interface-experience/presentation-frameworks/theme-systems/javascript-theme-accessors/object-based-theme-systems.md) — Reads colors and sizes from one registered theme object, so overriding a few values restyles every calendar element consistently.
- [Replaceable Phrases Tables](https://awesome-repositories.com/f/user-interface-experience/replaceable-phrases-tables.md) — Keeps every built-in label and screen-reader message in one lookup table that applications can override for translation.
- [Themeable](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/component-styling-tools/component-styling/themeable.md) — Reads colors and sizes from one registered theme object so overriding a few values restyles every calendar element consistently.

### Part of an Awesome List

- [Date Localization](https://awesome-repositories.com/f/awesome-lists/devtools/calendars-and-dates/date-localization.md) — Formats dates, month names, and weekday names from Moment.js locale data so one locale load localizes every calendar label.
- [Styling and Theming](https://awesome-repositories.com/f/awesome-lists/devtools/styling-and-theming.md) — Restyles the date picker through a central theme object for colors and sizes, or swaps default CSS for Aphrodite.

### Web Development

- [Controlled Component State](https://awesome-repositories.com/f/web-development/react-state-management/controlled-component-state.md) — Leaves selected dates and focus state with the host application, which passes them in as props and receives changes through callbacks.
