2.2.2.42 StartTime
As a top-level element of the Calendar class, the StartTime element is an optional element that specifies the start time of the calendar item. The client SHOULD include the StartTime element in a Sync command request ([MS-ASCMD] section 2.2.1.21).
For details about server behavior when a calendar event is received that is missing either the StartTime element (section 2.2.2.42), the EndTime element, or both, see section 3.2.4.4.
As an optional child element of the Exception element (section 2.2.2.21), the StartTime element specifies the start time of the calendar item exception. If the StartTime element is not specified as a child element of an Exception element, the value of the StartTime element for the exception is assumed to be the same as the value of the top-level StartTime element.
The StartTime element is defined as an element in the Calendar namespace. The value of this element is a string data type, represented as a Compact DateTime ([MS-ASDTYPE] section 2.7.2).
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support |
|---|---|
|
2.5 |
Yes |
|
12.0 |
Yes |
|
12.1 |
Yes |
|
14.0 |
Yes |
|
14.1 |
Yes |
|
16.0 |
Yes |
|
16.1 |
Yes |
When protocol version 2.5 is used, the StartTime element is required.
In protocol version 16.0 and 16.1, changing the start time of a recurring series will delete any exceptions present on the calendar item.
In protocol version 12.0, 12.1, 14.0, 14.1, 16.0, and 16.1, a Sync command response MUST contain one instance of the StartTime element if more than just DtStamp (section 2.2.2.18) or AttendeeType (section 2.2.2.6) has changed.