<!--
{
  "availability" : [
    "iOS: 4.0.0 -",
    "iPadOS: 4.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.8.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "EventKit",
  "identifier" : "/documentation/EventKit/EKAlarm",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "EventKit"
    ],
    "preciseIdentifier" : "c:objc(cs)EKAlarm"
  },
  "title" : "EKAlarm"
}
-->

# EKAlarm

A class that represents an alarm.

```
class EKAlarm
```

## Overview

An [`EKAlarm`](/documentation/EventKit/EKAlarm) object represents an alarm in Event Kit. Use the [`init(absoluteDate:)`](/documentation/EventKit/EKAlarm/init(absoluteDate:)) and [`init(relativeOffset:)`](/documentation/EventKit/EKAlarm/init(relativeOffset:)) class methods to create an alarm and use the properties to set information about an alarm. In macOS Mountain Lion, you can specify an action to trigger when the alarm fires via the `emailAddress`, `soundName`, or `url` property.

## Topics

### Creating an Alarm

[`init(absoluteDate:)`](/documentation/EventKit/EKAlarm/init(absoluteDate:))

Creates and returns an alarm with an absolute date.

[`init(relativeOffset:)`](/documentation/EventKit/EKAlarm/init(relativeOffset:))

Creates and returns an alarm with a relative offset.

### Accessing Alarm Dates

[`absoluteDate`](/documentation/EventKit/EKAlarm/absoluteDate)

The absolute date for the alarm.

[`relativeOffset`](/documentation/EventKit/EKAlarm/relativeOffset)

The offset from the start of an event, at which the alarm fires.

### Setting GeoFence-based Alarms

[`EKAlarmProximity`](/documentation/EventKit/EKAlarmProximity)

A value indicating whether an alarm is triggered by entering or exiting a region.

[`proximity`](/documentation/EventKit/EKAlarm/proximity)

A value indicating how a location-based alarm is triggered.

[`structuredLocation`](/documentation/EventKit/EKAlarm/structuredLocation)

The location to trigger an alarm.

### Triggering Alarm Actions

These properties are only available in macOS 10.8 or later.

[`EKAlarmType`](/documentation/EventKit/EKAlarmType)

A value that specifies what type of action occurs when the alarm triggers.

[`type`](/documentation/EventKit/EKAlarm/type)

The type of action to trigger when the alarm fires.

[`emailAddress`](/documentation/EventKit/EKAlarm/emailAddress)

The recipient of an email to send when the alarm triggers.

[`soundName`](/documentation/EventKit/EKAlarm/soundName)

The name of the sound to play when the alarm triggers.

[`url`](/documentation/EventKit/EKAlarm/url)

The URL to open when the alarm triggers.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)