# react-calendars

> A react calendar and datepicker library

Latest version **1.3.1** (published 2026-03-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-calendars
pnpm add react-calendars
yarn add react-calendars
bun add react-calendars
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.3.1 |
| Published | 2026-03-09 |
| First published | 2020-02-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 30.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Jérémie Dubuis |
| Maintainers | jeremiedubuis |
| Keywords | react, datepicker, calendar, date |

## Links

- npm: https://www.npmjs.com/package/react-calendars
- Repository: https://github.com/jeremiedubuis/react-calendars
- Homepage: https://github.com/jeremiedubuis/react-calendars#readme
- Issues: https://github.com/jeremiedubuis/react-calendars/issues
- npm.io page: https://npm.io/package/react-calendars

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.3.1 (latest) — 2026-03-09
- 1.3.0 — 2026-02-26
- 1.2.3 — 2026-02-26
- 1.2.2 — 2025-09-12
- 1.2.1 — 2025-09-12
- 1.2.0 — 2025-03-10
- 1.1.2 — 2024-11-29
- 1.1.1 — 2024-10-07
- 1.1.0 — 2024-07-09
- 1.0.9 — 2023-07-24
- 1.0.8 — 2023-07-24
- 1.0.7 — 2022-12-12
- 1.0.6 — 2022-01-26
- 1.0.5 — 2020-10-19
- 1.0.4 — 2020-10-19
- … 14 more at https://npm.io/package/react-calendars/versions

## README

react-calendars is react component library that allows the rendering of dynamic calendars and datepickers

# Installation

```
$ npm install react-calendars
```

# Usage

* [Calendar](#Calendar)
* [DatePicker](#DatePicker)
* [Configuration](#Configuration)

## Calendar

```jsx
<script>
import { Calendar } from 'react-calendars';
</script>

<Calendar />
```

### Props

#### month (number) && year (number)
Active month and year at which the calendar will first display

#### visibleMonths (number)
Amount of months to display in calendar

#### displayDayTitles (bool)
If true will display day titles as defined by config option daysTitles

#### displayMonthPicker (bool)
If true will display current month with previous and next buttons

#### displayMonthTitle (bool)
Will display the month name over each visible month in calendar

#### displayYearPicker (bool)
If true will display current year with previous and next buttons

#### renderMonthTitle (function)
This function can be used to override the way the month title is rendered, 
it takes two arguments : month (as defined in configuration) and year and 
should return a React node

#### selectedDay (Date)
Preselected date (will change when user clicks on date)

#### onSelect (function)
Callback that will be called on selected date change with three parameters: 
- the original event
- the selected date object
- the previous selected date object

#### dateClasses (array<array<Date,String>>)
The dateClasses prop is an array of arrays that contain a Date and string, if the date in the calendar matches the provided date, the class will be applied

#### after (node)
The after prop allows inserting content after the calendar dates

#### afterYearPicker (node)
The afterYearPicker prop allows inserting content after the year picker if displayYearPicker is true

#### afterMonthPicker (node)
The afterMonthPicker prop allows inserting content after the month picker if displayMonthPicker is true

#### isDisabledDay (function)
This function has three arguments (year, month, day) and should return a boolean to enable the disabled attribute on the Day button

## DatePicker
```jsx
<script>
import { DatePicker } from 'react-calendars';
</script>

<DatePicker />
```

### props

The datepicker uses all the props from the calendar component with extra optional props

### dateToValue (function)
The function used to translate the selected date to the string in the input field, by default:
```
date => date.toLocaleDateString(),
```
### valueToDate (function)
The function used to translate the string value in the field to a date object:
```
value => {
        value = value.split(/[/.,-]/g).map(v => parseInt(v));
        const testValue = new Date(2020, 0, 25).toLocaleDateString().split(/[/.,-]/g).map(v => parseInt(v));
        const yearIndex = testValue.indexOf(2020);
        const monthIndex = testValue.indexOf(1);
        const dayIndex = testValue.indexOf(25);
        return new Date(value[yearIndex], value[monthIndex] - 1, value[dayIndex])
    }
```

### calendarClassName (string)
The class name to apply to the calendar loaded in a react portal.

## Configuration

Global configuration can be changed by calling the setConfiguration method:
```
import { setConfiguration } from 'react-calendars';
setConfiguration({
    daysTitles: ['MON', 'TUE', 'WEN', 'THU', 'FRI', 'SAT', 'SUN'],
    firstDay: 1, // set to 0 to start week sunday
    libClassName: 'react-calendar',    
    monthTitles: [
         'January',
         'February',
         'March',
         'April',
         'May',
         'June',
         'July',
         'August',
         'September',
         'October',
         'November',
         'December'
    ],
    previousButton: 'Previous', // Inner of previous button on YearPicker and MonthPicker
    nextButton: 'Next' // Inner of next button on YearPicker and MonthPicker
});
```

---
_Source: https://npm.io/package/react-calendars · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
