There may be instances where any combination of these settings: DateSettings , RecurringDateSettings and DayofWeekSettings are assigned for a particular date. For example, if the working hours on the 25th of every month are set from 9am to 5pm (RecurringDateSettings) and if this needs to change for a single date (DateSettings), say on the 25th of December 2009 (e.g., Christmas day), the single date can be set as a non-workday. In order to support this functionality, the CalendarInfo determines which settings to apply for any given date based on a specific order of precedence.
The order of precedence is as follows:
Each member of the Owner object’s DateSettings collection takes precedence over all other Owner settings such as RecurringDateSettings, DayOfWeekSettings, and the WinCalendarInfo™ component’s DaysOfWeek property setting. When you explicitly set the DateSettings Object’s IsWorkDay property to false, then that date will be marked as a non-workday. On the other hand, if you set the IsWorkDay property to True, or if you populate the WorkingHours collection, then that date will be a workday.
If no Owner DateSettings are set for the given date, or if the IsWorkday property is set to false and no members exist in its WorkingHours collection, then the Owner object’s RecurringDateSettings collection will be checked for a recurrence which will have an occurrence on the given date.
If no Owner DateSettings or RecurringDateSettings are set for a given date or if the IsWorkDay property is set to false and no members exist in their WorkingHours collections, then the Owner object’s DayOfWeekSettings collection will be checked for the associated day of the week.
If no Owner DateSettings, RecurringDateSettings or DayofWeekSettings exists for a given date, then the UltraCalendarInfo component’s DaysOfWeek property is used to determine whether the associated date is a workday.
For more information on the order of precedence please refer the Remarks section of WorkingHours property.