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

Exceptions

Child Elements

Element	Required / Optional	Description
EnteredByOccurrences	Optional	Indicates whether the range of recurrence for the calendar exception is defined by a number of occurrences, or by a finish date.
TimePeriod	Optional	Defines a set of exception days.
Occurrences	Optional	Number of occurrences for which the calendar exception is valid.
Name	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).
Period	Optional	The period of recurrence for the exception.
DaysOfWeek	Optional	Specifies the day or days of the week the exception is valid.
MonthItem	Optional	The month item for which an exception recurrence is scheduled (day, weekday, Sunday, Monday, and so on).
MonthPosition	Optional	The position of a month item within a month (first, second, third, fourth, or last).
Month	Optional	The month for which an exception recurrence is scheduled ( 0 = January, …, 11 = December).
MonthDay	Optional	The day of the month on which an exception recurrence is scheduled.
DayWorking	Optional	Indicates whether the specified exception day type is a working day.
WorkingTimes	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>

See Also

Concepts

Calendar Elements and XML Structure

XML Schema for the Calendars Element