Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Queries events in a given time range.

Component Version macOS Windows Linux Server iOS SDK
Events 6.2 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "Events.Events" { ; StartDate; EndDate; Calendars } )   More


Parameter Description Example Flags
StartDate The start date to search from.
Can be empty.
EndDate The end date to search before. Optional
Calendars The identifier for the calendar you want to search.
Leave empty to search all.


Returns list or error.


Queries events in a given time range.
You can use this function to search for events between a range of dates.
You can pass nothing for start date to find all events before endDate.
You can pass nothing for both start and end date to get all events in the specified calendars.
You can pass nothing for calendars to fetch from all available calendars.
OS X Only: For performance reasons, this method will only return events within a four year timespan.
If the date range between the startDate and endDate is greater than four years, then it will be shortened to the first four years.

For events with occurrence dates, we return a 5 digit ID assigned by the plugin to distinguish between different occurrences.


Find events within next 24 hours:

MBS( "Events.Events"; get(CurrentHostTimestamp); get(CurrentHostTimestamp) + 24 * 60 * 60 )

See also

Example Databases

Blog Entries

This function checks for a license.

Created 10th March 2016, last changed 2nd May 2023

Events.EventStoreIdentifier - Events.IncompleteReminders