Exceptions 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 collection of exceptions associated with a calendar.

<Exceptions>
  <Exception>…</Exception>
</Exceptions>

Parent Elements

Calendar

Child Elements

Exception

Occurrences

Minimum: 0

Maximum: 1

Example

The following example contains definitions for two calendar exceptions in the Exceptions element. New Year's Day is defined yearly by the day of the month (Type = 2). Thanksgiving is defined yearly by position (Type = 3), where the holiday is on the fourth (MonthPosition = 3) Thursday (MonthItem = 7) in November (Month = 10).

<Exceptions>
  <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>
  <Exception>
    <EnteredByOccurrences>0</EnteredByOccurrences>
    <TimePeriod>
      <FromDate>2007-11-22T00:00:00</FromDate>
      <ToDate>2026-11-30T23:59:00</ToDate>
    </TimePeriod>
    <Occurrences>20</Occurrences>
    <Name>Thanksgiving</Name>
    <Type>3</Type>
    <Month>10</Month>
    <MonthItem>7</MonthItem>
    <MonthPosition>3</MonthPosition>
    <DayWorking>0</DayWorking>
  </Exception>
</Exceptions>

See Also

Concepts

Calendar Elements and XML Structure

XML Schema for the Calendars Element