StartTime Property (RecurrencePattern Object)

StartTime Property (RecurrencePattern Object)

The StartTime property returns or sets the starting date/time for each recurrence of the appointment. Read/write.

Syntax

objRecurPatt.StartTime

Data Type

Variant (vbDate format)

Remarks

The StartTime property contains the time at which the appointment is to begin every time it recurs. StartTime is always valid on a newly created RecurrencePattern object and defaults to the time component of the StartTime property of the AppointmentItem object that created this recurrence pattern.

The StartTime property ignores seconds and truncates the time component to the minute.

StartTime uses both the date and the time component of the vbDate format. When you set StartTime, the date component must match the date component of the PatternStartDate property, or CdoE_INVALID_PARAMETER is returned. When you read StartTime, you get the date/time of the start of the original appointment.

If the time component of EndTime is earlier than StartTime, each occurrence is treated as ending on the day after it starts.

The recurrence pattern's StartTime and EndTime properties are always held internally in the organizer's current time zone. By contrast, the AppointmentItem object's StartTime and EndTime properties are always held internally in UTC (Coordinated Universal Time, also known as GMT). However, all these properties are converted to the local messaging user's current time zone whenever they are displayed or read programmatically.

Setting the StartTime property causes CDO to force certain other recurrence pattern properties into conformance. Duration is recalculated from StartTime and EndTime.

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

See Also

Concepts

RecurrencePattern Object