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

Events.Events

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

Parameters

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

Result

Returns list or error.

Description

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.

Examples

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