StartTime Property (AppointmentItem Object)

StartTime Property (AppointmentItem Object)

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



Data Type

Variant (vbDate format)


The StartTime property uses both the date and the time component of the vbDate format. Its default value is the current time rounded down to the preceding half hour.

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

The value of StartTime must be less than that of the EndTime property. If you make settings that violate this constraint, your next call to the Update method returns CdoE_INVALID_OBJECT.

If you change the value of StartTime, Duration is automatically recalculated from the new StartTime and unchanged EndTime values.

You can apply a MessageFilter object to a Messages collection containing AppointmentItem objects and filter them on the StartTime and EndTime properties. The filter passes appointments starting on or before the date/time in CdoPR_START_DATE and ending on or after the date/time in CdoPR_END_DATE.

If you make this appointment recurring by calling its GetRecurrencePattern method, its StartTime, EndTime, and AllDayEvent properties are disabled, and any attempt to access them returns CdoE_NO_SUPPORT. Calling ClearRecurrencePattern returns the appointment to nonrecurring status, and these properties can once again be accessed. However, their values may have changed if the corresponding properties on the RecurrencePattern object were edited while the appointment was recurring.

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

Calendar folders are not supported in the public folders store provided with Microsoft® Exchange, and AppointmentItem objects are stored as Message objects. An attempt to read or write StartTime in this case returns CdoE_NO_SUPPORT.

Changes you make to properties on an AppointmentItem object take effect when you call the Send or Update method.

The StartTime property corresponds to the MAPI property PR_START_DATE.

See Also


AppointmentItem Object