React Native Calendar Events

React Native Module for IOS and Android Calendar Events

Install

npm install --save react-native-calendar-events

And link

react-native link

Or you can do it manually by following the instructions below.

Note that for iOS react-native link will not automatically add the required privacy usage description to your Info.plist file, you'll need to do that manually whatever.

iOS

Add RNCalendarEvents, as well as EventKit.framework to project libraries.

For iOS 8 compatibility, you may need to link your project with CoreFoundation.framework (status = Optional) under Link Binary With Libraries on the Build Phases page of your project settings.

Setting up privacy usage descriptions may also be require depending on which iOS version is supported. This involves updating the Property List, Info.plist, with the corresponding key for the EKEventStore api. Info.plist reference.

For updating the Info.plist key/value via Xcode, add a Privacy - Calendars Usage Description key with a usage description as the value. Resulting change to Info.plist should look something like:

<key>NSCalendarsUsageDescription</key>
<string>This app requires access to the calendar</string>

Android

Edit build.gradle to look like this:

apply plugin: 'com.android.application'

android {
  ...
}

dependencies {
  ...
  compile project(':react-native-calendar-events')
}

In settings.gradle, insert the following code:

include ':react-native-calendar-events'
project(':react-native-calendar-events').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-calendar-events/android')

Edit your MainApplication.java to look like this:

import com.calendarevents.CalendarEventsPackage;

...

  @Override
	protected List<ReactPackage> getPackages() {
		return Arrays.<ReactPackage>asList(
						new MainReactPackage(),
						new CalendarEventsPackage() // <-- Add this line
		);
	}
	...
}

If your apps targetSDK is 23 or higher, edit your MainActivity.java to look like this:

import com.calendarevents.CalendarEventsPackage;

public class MainActivity extends ReactActivity {
  ...

  @Override
  public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
      CalendarEventsPackage.onRequestPermissionsResult(requestCode, permissions, grantResults);
      super.onRequestPermissionsResult(requestCode, permissions, grantResults);
  }

  ...
}

Usage

Require the react-native-calendar-events module.

import RNCalendarEvents from 'react-native-calendar-events';

React-Native 0.40 and above use 1.3.x and above
React-Native 0.39 and below use 1.2.1 and below

NOTE: Starting from 1.0.0, this package will use Promises instead of Events.

Event Properties

Property	Value	Description
id	String (read-only)	Unique id for the calendar event.
calendarId	String (write-only)	Unique id for the calendar where the event will be saved. Defaults to the device's default calendar.
title	String	The title for the calendar event.
startDate	Date	The start date of the calendar event in ISO format.
endDate	Date	The end date of the calendar event in ISO format.
allDay	Bool	Indicates whether the event is an all-day event.
recurrence	String	The simple recurrence frequency of the calendar event `daily`, `weekly`, `monthly`, `yearly` or none.
recurrenceRule	Object	The events recurrence settings.
occurrenceDate (ios only)	Date (read-only)	The original occurrence date of an event if it is part of a recurring series.
isDetached (ios only)	Bool	Indicates whether an event is a detached instance of a repeating event.
url (ios only)	String	The url associated with the calendar event.
location	String	The location associated with the calendar event.
notes (ios only)	String	The notes associated with the calendar event.
description (android only)	String	The description associated with the calendar event.
alarms	Array	The alarms associated with the calendar event, as an array of alarm objects.
calendar	Object (read-only)	The calendar containing the event.

Recurrence Rule properties:

Property	Value	Description
frequency	String	Event recurring frequency `daily`, `weekly`, `monthly`, `yearly`
endDate	Date	Event recurring end date. This overrides occurrence
occurrence	Number	Number of event occurrences.
interval	Number	The interval between events of this recurrence.

authorizationStatus

Get calendar authorization status.

RNCalendarEvents.authorizationStatus()

Returns: Promise

fulfilled: String - denied, restricted, authorized or undetermined
rejected: Error

Example:

RNCalendarEvents.authorizationStatus()
  .then(status => {
    // handle status
  })
  .catch(error => {
   // handle error
  });

authorizeEventStore

Request calendar authorization. Authorization must be granted before accessing calendar events.

RNCalendarEvents.authorizeEventStore()

Returns: Promise

fulfilled: String - denied, restricted, authorized or undetermined
rejected: Error

Example:

RNCalendarEvents.authorizeEventStore()
  .then(status => {
    // handle status
  })
  .catch(error => {
   // handle error
  });

findEventById

Find calendar event by id. Returns a promise with fulfilled found events.

RNCalendarEvents.findEventById(id)

Parameters:

id: String - The events unique id.

Returns: Promise

fulfilled: Object | null - Found event with unique id.
rejected: Error

Example:

RNCalendarEvents.findEventById('FE6B128F-C0D8-4FB8-8FC6-D1D6BA015CDE')
  .then(event => {
    // handle events
  })
  .catch(error => {
   // handle error
  });

fetchAllEvents

Fetch all calendar events. Returns a promise with fulfilled found events.

RNCalendarEvents.fetchAllEvents(startDate, endDate, calendars)

Parameters:

startDate: Date - The start date of the range of events fetched.
endDate: Date - The end date of the range of events fetched.
calendars: Array - List of calendar id strings to specify calendar events. Defaults to all calendars if empty.

Returns: Promise

fulfilled: Array - Matched events within the specified date range.
rejected: Error

Example:

RNCalendarEvents.fetchAllEvents('2016-08-19T19:26:00.000Z', '2017-08-19T19:26:00.000Z', ['1', '2'])
  .then(events => {
    // handle events
  })
  .catch(error => {
   // handle error
  });

saveEvent

Creates calendar event.

RNCalendarEvents.saveEvent(title, settings);

Parameters:

title: String - The title of the event.
settings: Object - The event's settings.

Returns: Promise

fulfilled: String - Created event's ID.
rejected: Error

Example:

RNCalendarEvents.saveEvent('title', {
    location: 'location',
    notes: 'notes',
    startDate: '2016-08-19T19:26:00.000Z',
    endDate: '2017-08-19T19:26:00.000Z'
  })
  .then(id => {
    // handle success
  })
  .catch(error => {
    // handle error
  });

Update Event

Give the unique calendar event id to update an existing calendar event.

RNCalendarEvents.saveEvent(title, {id: 'FE6B128F-C0D8-4FB8-8FC6-D1D6BA015CDE'});

Parameters:

title: String - The title of the event.
settings: Object - The event's settings.
id: String - The event's unique id.

Returns: Promise

fulfilled: String - Updated event's ID.
rejected: Error

Example:

RNCalendarEvents.saveEvent('title', {
    id: 'FE6B128F-C0D8-4FB8-8FC6-D1D6BA015CDE',
    location: 'location',
    notes: 'notes',
    startDate: '2016-08-19T19:26:00.000Z',
    endDate: '2017-08-19T19:26:00.000Z'
  })
  .then(id => {
    // handle success
  })
  .catch(error => {
    // handle error
  });

Create calendar event with alarms

Alarm options:

Property	Value	Description
date	Date or Number	If a Date is given, an alarm will be set with an absolute date. If a Number is given, an alarm will be set with a relative offset (in minutes) from the start date.
structuredLocation	Object	(iOS Only) The location to trigger an alarm.

Alarm structuredLocation properties:

Property	Value	Description
title	String	The title of the location.
proximity	String	A value indicating how a location-based alarm is triggered. Possible values: `enter`, `leave`, `none`.
radius	Number	A minimum distance from the core location that would trigger the calendar event's alarm.
coords	Object	The geolocation coordinates, as an object with latitude and longitude properties

Example with date:

RNCalendarEvents.saveEvent('title', {
  location: 'location',
  notes: 'notes',
  startDate: '2016-08-19T19:26:00.000Z',
  endDate: '2017-08-19T19:26:00.000Z',
  alarms: [{
    date: -1 // or absolute date - iOS Only
  }]
});

Example with structuredLocation (iOS Only):

RNCalendarEvents.saveEvent('title', {
  location: 'location',
  notes: 'notes',
  startDate: '2016-08-19T19:26:00.000Z',
  endDate: '2017-08-19T19:26:00.000Z',
  alarms: [{
    structuredLocation: {
      title: 'title',
      proximity: 'enter',
      radius: 500,
      coords: {
        latitude: 30.0000,
        longitude: 97.0000
      }
    }
  }]
});

Example with recurrence:

RNCalendarEvents.saveEvent('title', {
  location: 'location',
  notes: 'notes',
  startDate: '2016-08-19T19:26:00.000Z',
  endDate: '2017-08-29T19:26:00.000Z',
  alarms: [{
    date: -1 // or absolute date - iOS Only
  }],
  recurrenceRule: {
    frequency: 'daily'
    interval: 2,
    endDate: '2017-08-29T19:26:00.000Z'
  }
});

removeEvent

Removes calendar event.

RNCalendarEvents.removeEvent(id);

Parameters:

id: String - The id of the event to remove.

Returns: Promise

fulfilled: Bool - Successful
rejected: Error

Example:

RNCalendarEvents.removeEvent('FE6B128F-C0D8-4FB8-8FC6-D1D6BA015CDE')
  .then(success => {
    // handle success
  })
  .catch(error => {
    // handle error
  });

removeFutureEvents (iOS Only)

Removes future (recurring) calendar events.

RNCalendarEvents.removeFutureEvents(id);

Parameters:

id: String - The id of the event to remove.

Returns: Promise

fulfilled: Bool - Successful
rejected: Error

Example:

RNCalendarEvents.removeFutureEvents('FE6B128F-C0D8-4FB8-8FC6-D1D6BA015CDE')
  .then(success => {
    // handle success
  })
  .catch(error => {
    // handle error
  });

findCalendars

Finds all the calendars on the device.

RNCalendarEvents.findCalendars();

Returns: Promise

fulfilled: Array - A list of known calendars on the device
rejected: Error

Example:

RNCalendarEvents.findCalendars()
  .then(calendars => {
    // handle calendars
  })
  .catch(error => {
    // handle error
  });

miguelramosfdz / react-native-calendar-events Goto Github PK