2.2.2.13 FirstDayOfWeek

The FirstDayOfWeek element is a child element of the Recurrence element (section 2.2.2.20) that specifies which day is considered the first day of the calendar week for this recurrence. It is defined as an element in the Tasks namespace.

The value of this element is an unsignedbyte data type, as specified in [MS-ASDTYPE] section 2.8.

A command request has a maximum of one FirstDayOfWeek child element per Recurrence element.

A command response has a maximum of one FirstDayOfWeek child element per Recurrence element. The server MUST return a FirstDayOfWeek element when the value of the Type element (section 2.2.2.29) is 1.

This element disambiguates recurrences across localities that define a different starting day for the calendar week. If this element is not included in the client’s request, then the server SHOULD identify the first day of the week for this recurrence according to the preconfigured options of the user when creating the task item.

The value of the FirstDayOfWeek element MUST be one of the values defined in the following table. If the client uses the Sync command request ([MS-ASCMD] section 2.2.1.21) to transmit a value not included in this table, then the server MUST return protocol status error 6. Sync command status values are specified in [MS-ASCMD] section 2.2.3.177.17.

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.