Skip to content

Calendar

Holds reminders and events.

Use the Calendar type to get a specific calendar. The calendar is used with the Reminder and CalendarEvent types when fetching reminders or events from a specific calendar or when inserting into a calendar. If you are fetching reminders or events from all calendars, you do not need to pass the calendars when performing the fetch with the Reminder or CalendarEvent types.

identifier

Calendar identifier.

identifier: string

title

Title of calendar.

title: string

isSubscribed

Whether the calendar is a subscribed calendar.

isSubscribed: bool

allowsContentModifications

Indicates whether items can be added, edited, and deleted in the calendar.

allowsContentModifications: bool

color

Color of calendar.

color: Color

-supportsAvailability

Checks if the calendar supports availability.

supportsAvailability(availability: string): bool

The following values are supported:

  • busy
  • free
  • tentative
  • unavailable

Not all calendars support all of these availabilities and some calendars may not support availability at all. Use this function to check if the calendar supports a specific availability.

Parameters

availability
string
Availability to check against.

Return value

bool
True if the calendar supports the availability, otherwise false.


-save

Saves calendar.

save()

Saves changes to the calendar.


+forReminders

Fetches calendars for reminders.

static forReminders(): Promise<[Calendar]>

A calendar can only hold either reminders or events. Call this function to fetch all calendars that can hold reminders.

Return value

Promise<[Calendar]>
Promise that provides the calendars when fulfilled.


+forEvents

Fetches calendars for events.

static forEvents(): Promise<[Calendar]>

A calendar can only hold either reminders or events. Call this function to fetch all calendars that can hold events.

Return value

Promise<[Calendar]>
Promise that provides the calendars when fulfilled.


+forRemindersByTitle

Fetches a calendar that holds reminders.

static forRemindersByTitle(title: string): Promise<Calendar>

Parameters

title
string
Title of calendar.

Return value

Promise
Promise that provides the calendar when fulfilled.


+forEventsByTitle

Fetches a calendar that holds events.

static forEventsByTitle(title: string): Promise<Calendar>

Parameters

title
string
Title of calendar.

Return value

Promise
Proomise that provides the calendar when fulfilled.


+defaultForReminders

Default calendar for reminders.

static defaultForReminders(): Promise<Calendar>

A calendar can only hold either reminders or events. Call this function to get the default calendar that can hold reminders.

Return value

Promise
Proomise that provides the calendar when fulfilled.


+defaultForEvents

Default calendar for events.

static defaultForEvents(): Promise<Calendar>

A calendar can only hold either reminders or events. Call this function to get the default calendar that can hold events.

Return value

Promise
Proomise that provides the calendar when fulfilled.


+presentPicker

Presents a view for picking calendars.

static presentPicker(allowMultiple: bool): Promise<[Calendar]>

Parameters

allowMultiple
bool
Whether to allow picking multiple calenders. Defaults to false.

Return value

Promise<[Calendar]>
Promise that provides the calendars when fulfilled.