Class

EKEvent

A class that represents an event added to a calendar.

Declaration

@interface EKEvent : EKCalendarItem

Overview

Use the eventWithEventStore: method to create a new event. Use the properties in the class to get and modify certain information about an event. Other properties, such as the event’s title and calendar, are inherited from the parent class EKCalendarItem.

Topics

Creating Events

+ eventWithEventStore:

Creates and returns a new event belonging to a specified event store.

Scheduling Events

EKEventStatus

The event’s status.

EKEventAvailability

The event’s availability setting for scheduling purposes.

Comparing Events

- compareStartDateWithEvent:

Compares the start date of the receiving event with the start date of another event.

Accessing Event Properties

eventIdentifier

A unique identifier for the event.

availability

The availability setting for the event.

startDate

The start date of the event.

endDate

The end date for the event.

allDay

A Boolean value that indicates whether the event is an all-day event.

- recurrenceRule

The recurrence rule associated with the event.

occurrenceDate

The original occurrence date of an event if it is part of a recurring series.

isDetached

A Boolean value that indicates whether an event is a detached instance of a repeating event.

organizer

The organizer associated with the event.

status

The status of the event.

birthdayPersonID

The Address Book framework record identifier of the person for this birthday event.

Deprecated
birthdayPersonUniqueID

The Address Book framework record identifier of the person for this birthday event.

Deprecated

Refreshing Event Data

- refresh

Updates the event’s data with the current information in the Calendar database.

Relationships

Inherits From

See Also

Events and Reminders

Creating Events and Reminders

Create and modify events and reminders in a user's database.

Retrieving Events and Reminders

Fetch events and reminders from the Calendar database.

Updating with Notifications

Register to be notified about changes and keep your app up to date.

EKReminder

A class that represents a reminder added to a calendar.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software