CalendarEvent

var evt,
    exceptionEvt,
    calendar = blackberry.pim.calendar,
    CalendarRepeatRule = calendar.CalendarRepeatRule;

function onExceptionSaveSuccess(exceptionEvtCreated) {
   // Exception event created successcully, now the recurring event
   // has the following occurences:
   // Jan 22, 2013, 12:00
   // Jan 25, 2013, 12:00
   // Jan 29, 2013, 12:00
   // Feb  1, 2013, 12:00
   // Feb  5, 2013, 12:00
   // Feb  8, 2013, 12:00
   // Feb 12, 2013, 12:00
   // Feb 16, 2013, 12:00
   exceptionEvt = exceptionEvtCreated;
   // exception event has a different id than the original event
   alert("Exception event created successfully: " + exceptionEvt.id);

   // get a fresh copy of the recurring event which contains the
   // updated recurrence
   evt = calendar.getEvent(evt.id, evt.folder);
}

function onSaveSuccess(created) {
   // Recurring event created successcully, with the following occurences:
   // Jan 22, 2013, 12:00
   // Jan 25, 2013, 12:00
   // Jan 29, 2013, 12:00
   // Feb  1, 2013, 12:00
   // Feb  5, 2013, 12:00
   // Feb  8, 2013, 12:00
   // Feb 12, 2013, 12:00
   // Feb 15, 2013, 12:00
   evt = created;

   // The following code replaces the last occurence with an exception
   // occurence on the day after
   exceptionEvt = evt.createExceptionEvent(new Date("Feb 15, 2013, 12:00"));
   exceptionEvt.start = new Date("Feb 16, 2013, 12:00");
   exceptionEvt.end = new Date("Feb 16, 2013, 12:30");
   exceptionEvt.save(onExceptionSaveSuccess, onSaveError);
}

function onSaveError(error) {
   alert("Error saving event to device: " + error.code);
}

function createRecurringEvent() {
   var start = new Date("Jan 21, 2013, 12:00");
   var end = new Date("Jan 21, 2013, 12:30");
   var location = "some location";
   var summary = "My recurring event";
   var repeatRule = new CalendarRepeatRule({
      "frequency": CalendarRepeatRule.FREQUENCY_WEEKLY,
      "expires": new Date("Feb 18, 2013, 12:00"),
      "dayInWeek": CalendarRepeatRule.TUESDAY | CalendarRepeatRule.FRIDAY
   });
   evt = calendar.createEvent({
      "summary": summary,
      "location": location,
      "start": start,
      "end": end,
      "recurrence": repeatRule
   });
   evt.save(onSaveSuccess, onSaveError);
}

var calendar = blackberry.pim.calendar,
    evt;

function testRemove() {
   // omitting optional folder parameter in createEvent(), calling save()
   // will save event to default calendar folder
   evt = calendar.createEvent({
       "summary": "Picnic",
       "location": "South Park",
       "start": new Date("Jan 1, 2013, 13:00"),
       "end": new Date("Jan 1, 2013, 16:00"),
       "transparency": calendar.CalendarEvent.SENSITIVITY_PERSONAL,
       "reminder": 2 * 24 * 60 // 2 days before start
   });

   // will result in error, since the event has not been saved to the
   // calendar folder yet
   evt.remove(onSuccess, onError);

   // save event to default calendar folder
   evt.save(function (saved) {
      evt = saved; // replace original evt object
      alert("Event saved: " + evt.id);
   }, function (error) {
      alert("Error saving event, error code: " + error.code);
   });

   // this will remove the event from the calendar folder
   setTimeout("evt.remove(onSuccess, onError)", 1000);
}

function onSuccess() {
   alert("Event removed!");
}

function onError(error) {
   alert("Failed to remove event, error code: " + error.code);
}

function removeSingleOccurrence(keyword, dateToRemove) {
   // find all instances of the recurring event
   calendar.findEvents({
      "filter": {
          "substring": keyword,
          "expandRecurring": true
      }
   }, function (events) {
      alert("Found " + events.length + " events that matches filter!");
      events.forEach(function (evt) {
         if (evt.start.toISOString() === dateToRemove.toISOString()) {
            evt.remove(function () {
               alert(dateToRemove + " instance removed successfully!");
            }, function (error) {
               alert(dateToRemove + " instance not removed, error code: " + error.code);
            },
            false); // pass false to remove only this single occurrence
         }
      });
   }, function (error) {
      alert("Failed to find events, error code: " + error.code);
   });
}

var calendar = blackberry.pim.calendar,
    // omitting optional folder parameter in createEvent(), calling save() will
    // save event to default calendar folder
    evt = calendar.createEvent({
        "summary": "Picnic",
        "location": "South Park",
        "start": new Date("Jan 1, 2013, 13:00"),
        "end": new Date("Jan 1, 2013, 16:00"),
        "transparency": calendar.CalendarEvent.SENSITIVITY_PERSONAL,
        "reminder": 2 * 24 * 60 // 2 days before start
    });

// save event to default calendar folder
evt.save(function (saved) {
    evt = saved; // replace original evt object
    alert("Event saved: " + evt.id);
}, function (error) {
    alert("Error saving event, error code: " + error.code);
});

// edit event description
evt.description = "This is going to be fun!";
// save changes to event
evt.save(function (saved) {
    evt = saved; // replace original evt object
    alert("Event description: " + evt.description);
}, function (error) {
    alert("Error saving event, error code: " + error.code);
});