Calendar.Alarm.SetRelativeTrigger
---------------------------------

Sets the relative trigger value.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Calendar](component_Calendar.md) | [3.5](newinversion35.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

### Deprecated

This function was [deprecated](deprecated.md).

MBS( "Calendar.Alarm.SetRelativeTrigger"; alarmRef; TimeOffset ) 

**MBS**( **"Calendar.Alarm.SetRelativeTrigger";** /\* Sets the relative trigger value. \*/  
**$alarmRef**; /\* The reference to the calendar alarm. \*/   
**$TimeOffset**) /\* The relative time offset in seconds.e.g. -15\*60 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| alarmRef | The reference to the calendar alarm. | $alarmRef |
| TimeOffset | The relative time offset in seconds. | -15\*60 |

### Result

Returns OK or error.

### Description

Sets the relative trigger value.  
Setting a relativeTrigger will also set the absoluteTrigger to undefined.  
Value is in seconds relative to parent calendar item.  
### See also

- [Calendar.Alarm.GetAbsoluteTrigger](CalendarAlarmGetAbsoluteTrigger.md)
- [Calendar.Alarm.GetRelativeTrigger](CalendarAlarmGetRelativeTrigger.md)
- [Calendar.Alarm.SetAbsoluteTrigger](CalendarAlarmSetAbsoluteTrigger.md)

### Example Databases

- [Mac and iOS/Events/Calendar/Calendar Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Events/Calendar/Calendar%20Test.shtml#6ScriptAnchor_)

### FileMaker Magazin

- [Ausgabe 1/2014, Seite 33](https://filemaker-magazin.de/neuigkeit/3720-Appetithappen-FMM_201401)

This function checks for a license.

Created 18th August 2014 , last changed 13th September 2015

  
[Calendar.Alarm.SetRelatedTo](CalendarAlarmSetRelatedTo.md) - [Calendar.Alarm.SetSound](CalendarAlarmSetSound.md)

[HTML Version](CalendarAlarmSetRelativeTrigger.shtml)