Interval Property (RecurrencePattern Object)

The Interval property returns or sets the number of recurrence units between recurrences of the appointment. Read/write.

Syntax

objRecurPatt.Interval

Data Type

Long

Remarks

The Interval property is used when the AppointmentItem is to recur less often than every recurrence unit, such as once every three days, once every two weeks, or once every six months. Interval contains a value representing the frequency of recurrence in terms of recurrence units.

Interval is always valid on a newly created RecurrencePattern object and defaults to 1, which is its minimum value. Its maximum value depends on the setting of the RecurrenceType property as follows:

RecurrenceType setting Maximum Interval value
CdoRecurTypeDaily 999
CdoRecurTypeMonthly
CdoRecurTypeMonthlyNth
99
CdoRecurTypeYearly
CdoRecurTypeYearlyNth
1
CdoRecurTypeWeekly 99

Setting the Interval property causes CDO to force certain other recurrence pattern properties into conformance. PatternEndDate is recalculated from PatternStartDate, Occurrences, and Interval. If the resulting PatternEndDate is January 1, 4000 or later, NoEndDate is automatically reset to True, Occurrences is reset to 1,490,000, PatternEndDate is reset to the month and day of PatternStartDate in the year 4001, and the recurrence pattern is considered to extend infinitely far into the future.

Changes you make to properties on a RecurrencePattern object take effect when you call the underlying appointment's Send or Update method.