2.2.2.20 EndTime

As a top-level element of the Calendar class, the EndTime element is an optional element that specifies the end time of the calendar item. The client SHOULD include the EndTime element in a Sync command request ([MS-ASCMD] section 2.2.1.21). The EndTime element MUST be present in the response as a top-level element, even if the value of the AllDayEvent element (section 2.2.2.1) is 1.

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 EndTime element specifies the end time of the calendar item exception. A command request or response has a maximum of one EndTime child element per Exception element. If the EndTime element is not specified as a child element of the Exception element, the value of the EndTime element for the calendar item exception is assumed to be the same as the value of the top-level EndTime element.

The EndTime 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 EndTime element MUST be included in the request.

In protocol version 16.0 and 16.1, changing the end time of a recurring series will delete any exceptions present on the calendar item.