Using rrule NPM package to display recurring events in big calendar using Javascript & ReactJS

Mohan pd.
Written by Mohan pd. on
Using rrule NPM package to display recurring events in big calendar using Javascript & ReactJS

Rrule package is the Javascript package to generate array of dates for recurring event, special when you are implementing UI like google calendar, recursive event creator when event might repeat for a year on daily basic.

rrule.js supports recurrence rules as defined in the iCalendar RFC, with a few important differences. It is a partial port of the rrule module from the excellent python-dateutil library. On top of that, it supports parsing and serialization of recurrence rules from and to natural language.

In this article, we will look at the basic implementation and important aspect of rrules.


Installation is fairly simple, for npm user you can user terminal to install it in your project as follow.

$ yarn add rrule
# or 
$ npm install rrule

Alternatively, download manually:

rrule.min.js (bundled, minified)
rrule.js (bundled, not minified)
rrule-tz.min.js (with timezone support, bundled, minified)
rrule-tz.js (with timezone support, bundled, not minified)
<script src="rrule/dist/es5/rrule.min.js"></script>


RRules basically export three important function/ modules which are ` RRule, RRuleSet, rrulestr `. we can import three packages as follow.

import { RRule, RRuleSet, rrulestr } from 'rrule'

Example implementation

// Create a rule:
const rule = new RRule({
  freq: RRule.WEEKLY,  // repeate weekly, possible freq [DAILY, WEEKLY, MONTHLY, ]
  interval: 5,
  byweekday: [RRule.MO, RRule.FR],
  dtstart: new Date(Date.UTC(2012, 1, 1, 10, 30)),
  until: new Date(Date.UTC(2012, 12, 31))

Now, you can invoke above function:


While will gives output as:

[ '2012-02-03T10:30:00.000Z',
 /* … */]

Dealing with timezone

As we know, dealing with timezone is little tricky in javascript. By default, RRule deals in "floating" times or UTC timezones.. If you want results in a specific timezone, RRule also provides timezone support. Below is the example:

new RRule({
  dtstart: new Date(Date.UTC(2018, 1, 1, 10, 30)),
  count: 1,
  tzid: 'Asia/Tokyo'

assuming the system timezone is set to America/Los_Angeles, you get:
[ '2018-01-31T17:30:00.000Z' ]
which is the time in Los Angeles when it’s 2018-02-01T10:30:00 in Tokyo

Store and parse recurring date in string

RRules provide a rrulestr api to extract a date from string. Its mean you can store it in string. Example below will explain the concept better.

   // Parse a RRule string, return a RRule object

Fairly clear, we have store a recurring date in string where DTSTART indicate start date, FREQ=MONTHLY mean it is repeated monthly and count state that it will re-occurs for next five month.

You might now have a basic idea about the power of rrule.

For more read official documentation

Read more in official docs here

Mohan pd.

Mohan pd.

Author of The Coders Blog. Also a professional fullstack javascript developer working with various tech company and client around world.


comments powered by Disqus