react-native-fetch-calendar-events

React-Native-Fetch-Calendar-Events

It's a fork of React-Native-Calendar-Events with support for fetching calendar events on Android. As soon as code will be refactored, going to remove this repo and send a PR to "react-native-calendar-events".

React Native Module for fetching Calendar Events on iOS and Android.

Install

npm install react-native-fetch-calendar-events

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.

Android

• Edit build.gradle to look like this:

apply plugin: 'com.android.application'

android {
  ...
}

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

• In settings.gradle, insert the following code:

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

• Edit your MainActivity.java to look like this:

package com.myapp;

....
import com.calendarevents.CalendarEventsPackage;

public class MainActivity extends extends ReactActivity {

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

• 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-fetch-calendar-events module.

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

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

Properties

Property	Value	Description
id	String (read-only)	Unique id for the calendar event.
title	String	The title for the calendar event.
startDate	Date	The start date of the calendar event.
endDate	Date	The end date of the calendar event.
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.
occurrenceDate	Date (read-only)	The original occurrence date of an event if it is part of a recurring series.
isDetached	Bool	Indicates whether an event is a detached instance of a repeating event.
location	String	The location associated with the calendar event.
notes	String	The notes associated with the calendar event.
alarms	Array	The alarms associated with the calendar event, as an array of alarm objects.

authorizationStatus

Get authorization status for IOS EventStore.

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 authorization to IOS EventStore. 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
  });

fetchAllEvents

Fetch all calendar events from EventStore (iOS) and CalendarContract (Android). Returns a promise with fulfilled with found events.

RNCalendarEvents.fetchAllEvents(startDate, endDate)

Parameters:

• startDate: Date - The start date of the range of events fetched. (iOS Only)
• endDate: Date - The end date of the range of events fetched. (iOS Only)

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')
  .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-10-01T09:45:00.000UTC',
    endDate: '2016-10-02T09:45:00.000UTC'
  })
  .then(id => {
    // handle success
  })
  .catch(error => {
    // handle error
  });

Update Event (iOS Only)

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

Parameters:

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

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-10-01T09:45:00.000UTC',
    endDate: '2016-10-02T09:45:00.000UTC'
  })
  .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-10-01T09:45:00.000UTC',
  endDate: '2016-10-02T09:45:00.000UTC',
  alarms: [{
    date: -1 // or absolute date - iOS Only
  }]
});

Example with structuredLocation (iOS Only):

RNCalendarEvents.saveEvent('title', {
  location: 'location',
  notes: 'notes',
  startDate: '2016-10-01T09:45:00.000UTC',
  endDate: '2016-10-02T09:45:00.000UTC',
  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-10-01T09:45:00.000UTC',
  endDate: '2016-10-02T09:45:00.000UTC',
  alarms: [{
    date: -1 // or absolute date - iOS Only
  }],
  recurrence: 'daily'
});

removeEvent (iOS Only)

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
  });