OccurrenceCalculator.CalcOccurrences(TimeInterval, Appointment) Method

Creates a sequence of appointments for the specified pattern within the specified time interval.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v24.2.Core.dll

NuGet Package: DevExpress.Scheduler.Core

Declaration

C#

public AppointmentBaseCollection CalcOccurrences(
    TimeInterval interval,
    Appointment pattern
)

VB.NET

Public Function CalcOccurrences(
    interval As TimeInterval,
    pattern As Appointment
) As AppointmentBaseCollection

Parameters

Name	Type	Description
interval	TimeInterval	A TimeInterval object, that is the interval in which the occurrences are created.
pattern	Appointment	An Appointment object, that is the pattern of recurrence series.

Returns

Type	Description
AppointmentBaseCollection	An AppointmentBaseCollection object, that is a collection of occurrences.

Remarks

Use the CalcOccurrences method to generate a sequence of appointments with AppointmentType.Occurrence type for further investigation or comparison.

Note

The OccurrenceCalculator creates a collection of occurrences based on the recurrence pattern only. It is not aware of any exceptions (deleted and changed occurrences). When appointment pattern evolves in the Scheduler, the recurrence series created by the OccurrenceCalculator is merged with data on deleted and changed occurrences.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CalcOccurrences(TimeInterval, Appointment) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-scheduler-recurrence-series-occurrencecalculator/CS/OccurrenceCalculatorSample/Form1.cs#L45

TimeInterval processedInterval = new TimeInterval(DateTime.Today, DateTime.Today.AddDays(7));
AppointmentBaseCollection calculatedOccurrences = calc.CalcOccurrences(processedInterval, pattern);

VB.NET

winforms-scheduler-recurrence-series-occurrencecalculator/VB/OccurrenceCalculatorSample/Form1.vb#L43

Dim processedInterval As TimeInterval = New TimeInterval(Date.Today, Date.Today.AddDays(7))
Dim calculatedOccurrences As AppointmentBaseCollection = calc.CalcOccurrences(processedInterval, pattern)
' Create normal appointments in place of occurrences.