Exception Element
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
The Exception element defines a single calendar exception.
<Exception>
ComplexTypeValue
</Exception>
ent Elements
Child Elements
Element |
Required / Optional |
Description |
|---|---|---|
Optional |
Indicates whether the range of recurrence for the calendar exception is defined by a number of occurrences, or by a finish date. |
|
Optional |
Defines a set of exception days. |
|
Optional |
Number of occurrences for which the calendar exception is valid. |
|
Optional |
Name of the calendar exception. |
|
Type |
Optional |
Type of calendar exception (daily, yearly by day of the month, monthly by position, weekly, by day count, and so on). |
Optional |
The period of recurrence for the exception. |
|
Optional |
Specifies the day or days of the week the exception is valid. |
|
Optional |
The month item for which an exception recurrence is scheduled (day, weekday, Sunday, Monday, and so on). |
|
Optional |
The position of a month item within a month (first, second, third, fourth, or last). |
|
Optional |
The month for which an exception recurrence is scheduled ( 0 = January, …, 11 = December). |
|
Optional |
The day of the month on which an exception recurrence is scheduled. |
|
Optional |
Indicates whether the specified exception day type is a working day. |
|
Optional |
The collection of working times that define the time worked on the working day. There must be at least one WorkingTime and a maximum of five specified. |
Occurrences
Minimum: 0 Maximum: Unbounded |
Example
In the following example, the Exception element defines a calendar exception for the 20 occurrences of New Year's Day from January 1, 1997 to January 1, 2026.
<Exception>
<EnteredByOccurrences>0</EnteredByOccurrences>
<TimePeriod>
<FromDate>2007-01-01T00:00:00</FromDate>
<ToDate>2026-01-01T23:59:00</ToDate>
</TimePeriod>
<Occurrences>20</Occurrences>
<Name>New Year's Day</Name>
<Type>2</Type>
<Month>0</Month>
<MonthDay>1</MonthDay>
<DayWorking>0</DayWorking>
</Exception>