forceCalendar
API Reference

ICSParser

API reference for the ICSParser class.

import { ICSParser } from '@forcecalendar/core';

Constructor

new ICSParser()

Methods

MethodSignatureReturns
parse(icsString: string) => EventData[]Array of event objects
export(events: EventData[], calendarName?: string) => stringICS string

parse() Output

Each event object contains:

PropertySource ICS Property
titleSUMMARY
startDTSTART
endDTEND
descriptionDESCRIPTION
locationLOCATION
recurrenceRuleRRULE
statusSTATUS
uidUID
organizerORGANIZER
attendeesATTENDEE
categoriesCATEGORIES
remindersVALARM
allDayDetected from date-only DTSTART

export() Output

Produces a valid RFC 5545 ICS string with:

  • BEGIN:VCALENDAR / END:VCALENDAR wrapper
  • VERSION:2.0
  • PRODID identifier
  • VEVENT blocks for each event
  • VALARM blocks for reminders
  • Text escaping (commas, semicolons, newlines)
  • Line folding at 75 octets