1.6.3 • Public • Published

    React Native Calendars ✨ 🗓️ 📆

    NPM Version Build Status

    This module includes various customizable react native calendar components.

    The package is both Android and iOS compatible.

    Try it out

    You can run example module by performing these steps:

    $ git clone git@github.com:wix/react-native-calendars.git
    $ cd react-native-calendars/example
    $ npm install
    $ react-native run-ios

    You can check example screens source code in example module screens

    This project is compatible with Expo/CRNA (without ejecting), and the examples have been published on Expo


    $ npm install --save react-native-calendars

    The solution is implemented in JavaScript so no native module linking is required.


    import { Calendar, CalendarList, Agenda } from 'react-native-calendars';

    All parameters for components are optional. By default the month of current local date will be displayed.

    Event handler callbacks are called with calendar objects like this:

      day: 1,     // day of month (1-31)
      month: 1,   // month of year (1-12)
      year: 2017, // year
      timestamp,   // UTC timestamp representing 00:00 AM of this date
      dateString: '2016-05-13' // date formatted as 'YYYY-MM-DD' string

    Parameters that require date types accept YYYY-MM-DD formated datestrings, JavaScript date objects, calendar objects and UTC timestamps.

    Calendars can be localized by adding custom locales to LocaleConfig object:

    import {LocaleConfig} from 'react-native-calendars';
    LocaleConfig.locales['fr'] = {
      monthNames: ['Janvier','Février','Mars','Avril','Mai','Juin','Juillet','Août','Septembre','Octobre','Novembre','Décembre'],
      monthNamesShort: ['Janv.','Févr.','Mars','Avril','Mai','Juin','Juil.','Août','Sept.','Oct.','Nov.','Déc.'],
      dayNames: ['Dimanche','Lundi','Mardi','Mercredi','Jeudi','Vendredi','Samedi'],
      dayNamesShort: ['Dim.','Lun.','Mar.','Mer.','Jeu.','Ven.','Sam.']
    LocaleConfig.defaultLocale = 'fr';


    Basic parameters

      // Initially visible month. Default = Date()
      // Minimum date that can be selected, dates before minDate will be grayed out. Default = undefined
      // Maximum date that can be selected, dates after maxDate will be grayed out. Default = undefined
      // Handler which gets executed on day press. Default = undefined
      onDayPress={(day) => {console.log('selected day', day)}}
      // Month format in calendar title. Formatting values: http://arshaw.com/xdate/#Formatting
      monthFormat={'yyyy MM'}
      // Handler which gets executed when visible month changes in calendar. Default = undefined
      onMonthChange={(month) => {console.log('month changed', month)}}
      // Hide month navigation arrows. Default = false
      // Replace default arrows with custom ones (direction can be 'left' or 'right')
      renderArrow={(direction) => (<Arrow />)}
      // Do not show days of other months in month page. Default = false
      // If hideArrows=false and hideExtraDays=false do not switch month when tapping on greyed out
      // day from another month that is visible in calendar page. Default = false
      // If firstDay=1 week starts from Monday. Note that dayNames and dayNamesShort should still start from Sunday.
      // Hide day names. Default = false

    Date marking

    !Disclaimer! Make sure that markedDates param is immutable. If you change markedDates object content but the reference to it does not change calendar update will not be triggered.

    Dot marking

      // Collection of dates that have to be marked. Default = {}
        '2012-05-16': {selected: true, marked: true},
        '2012-05-17': {marked: true},
        '2012-05-18': {disabled: true}

    Interval marking

      // Collection of dates that have to be colored in a special way. Default = {}
        {'2012-05-20': [{textColor: 'green'}],
         '2012-05-22': [{startingDay: true, color: 'green'}],
         '2012-05-23': [{endingDay: true, color: 'green', textColor: 'gray'}],
         '2012-05-04': [{startingDay: true, color: 'green'}, {endingDay: true, color: 'green'}]
      // Date marking style [simple/interactive]. Default = 'simple'

    Keep in mind that different marking types are not compatible. You can use just one marking style for calendar.

    Displaying data loading indicator

    The loading indicator next to month name will be displayed if <Calendar /> has displayLoadingIndicator property and markedDays collection does not have a value for every day of the month in question. When you load data for days, just set [] or special marking value to all days in markedDates collection.

    Customizing look & feel

      // Specify style for calendar container element. Default = {}
        borderWidth: 1,
        borderColor: 'gray',
        height: 350
      // Specify theme properties to override specific styles for calendar parts. Default = {}
        backgroundColor: '#ffffff',
        calendarBackground: '#ffffff',
        textSectionTitleColor: '#b6c1cd',
        selectedDayBackgroundColor: '#00adf5',
        selectedDayTextColor: '#ffffff',
        todayTextColor: '#00adf5',
        dayTextColor: '#2d4150',
        textDisabledColor: '#d9e1e8',
        dotColor: '#00adf5',
        selectedDotColor: '#ffffff',
        arrowColor: 'orange',
        monthTextColor: 'blue',
        textDayFontFamily: 'monospace',
        textMonthFontFamily: 'monospace',
        textDayHeaderFontFamily: 'monospace',
        textDayFontSize: 16,
        textMonthFontSize: 16,
        textDayHeaderFontSize: 16


    <CalendarList /> is scrollable semi-infinite calendar composed of <Calendar /> components. Currently it is possible to scroll 4 years back and 4 years to the future. All paramters that are available for <Calendar /> are also available for this component. There are also some additional params that can be used:

      // Callback which gets executed when visible months change in scroll view. Default = undefined
      onVisibleMonthsChange={(months) => {console.log('now these months are visible', months);}}
      // Max amount of months allowed to scroll to the past. Default = 50
      // Max amount of months allowed to scroll to the future. Default = 50
      // Enable or disable scrolling of calendar list


    An advanced agenda component that can display interactive listings for calendar day items.

      // the list of items that have to be displayed in agenda. If you want to render item as empty date
      // the value of date key kas to be an empty array []. If there exists no value for date key it is
      // considered that the date in question is not yet loaded
        {'2012-05-22': [{text: 'item 1 - any js object'}],
         '2012-05-23': [{text: 'item 2 - any js object'}],
         '2012-05-24': [],
         '2012-05-25': [{text: 'item 3 - any js object'},{text: 'any js object'}],
      // callback that gets called when items for a certain month should be loaded (month became visible)
      loadItemsForMonth={(month) => {console.log('trigger items loading')}}
      // callback that gets called on day press
      onDayPress={(day)=>{console.log('day pressed')}}
      // callback that gets called when day changes while scrolling agenda list
      onDayChange={(day)=>{console.log('day changed')}}
      // initially selected day
      // Minimum date that can be selected, dates before minDate will be grayed out. Default = undefined
      // Maximum date that can be selected, dates after maxDate will be grayed out. Default = undefined
      // Max amount of months allowed to scroll to the past. Default = 50
      // Max amount of months allowed to scroll to the future. Default = 50
      // specify how each item should be rendered in agenda
      renderItem={(item, firstItemInDay) => {return (<View />);}}
      // specify how each date should be rendered. day can be undefined if the item is not first in that day.
      renderDay={(day, item) => {return (<View />);}}
      // specify how empty date content with no items should be rendered
      renderEmptyDate={() => {return (<View />);}}
      // specify how agenda knob should look like
      renderKnob={() => {return (<View />);}}
      // specify your item comparison function for increased performance
      rowHasChanged={(r1, r2) => {return r1.text !== r2.text}}
      // Hide knob button. Default = false
      // By default, agenda dates are marked if they have at least one item, but you can override this if needed
        '2012-05-16': {selected: true, marked: true},
        '2012-05-17': {marked: true},
        '2012-05-18': {disabled: true}
      // agenda theme
        agendaDayTextColor: 'yellow',
        agendaDayNumColor: 'green',
        agendaTodayColor: 'red',
        agendaKnobColor: 'blue'
      // agenda container style


    See also the list of contributors who participated in this project.


    Pull requests are welcome. npm run test and npm run lint before push.




    npm i @cutii/react-native-calendars

    DownloadsWeekly Downloads






    Last publish


    • matthieulemoine