ScheduleByMonthDayOfWeek (calendarTriggerType) Element

Article
12/11/2020

Specifies a monthly day-of-week schedule. For example, the task starts on specific days of the week, weeks of the month, and months of the year.

<xs:element name="ScheduleByMonthDayOfWeek"
    type="monthlyDayOfWeekScheduleType"
 />

The ScheduleByMonthDayOfWeek element is defined by the monthlyDayOfWeekScheduleType complex type.

Parent element

Element	Derived from	Description
CalendarTrigger	calendarTriggerType	Specifies a daily, weekly, monthly, or a monthly day-of-the-week (DOW) trigger.

Child elements

Element	Type	Description
DaysOfWeek	daysOfWeekType	Specifies the days of the week in which the task runs.
Months	monthsType	Specifies the months of the year during which the task runs.
Weeks	unsignedByte	Specifies the interval between the weeks in the schedule.

Remarks

The time of day that the task is started is set by the StartBoundary element.

For scripting development, a monthly day-of-week trigger is specified using the MonthlyDOWTrigger object.

For C++ development, a monthly day-of-week trigger is specified using the IMonthlyDOWTrigger interface.

The child elements listed above are defined by the monthlyDayOfWeekScheduleType complex element types.

Examples

The following XML defines a monthly day of week calendar trigger that starts a task ( at 8:00 AM) on Monday of the first week for each month of the year.

<CalendarTrigger>
    <StartBoundary>2005-01-01T08:00:00</StartBoundary>
    <EndBounadry>2007-01-01T00:00:00</EndBoundary>
    <ScheduleByMonthDayOfWeek>
        <Weeks>
            <Week>1</Week>
        </Weeks>
        <DaysOfWeek>
            <Monday/>
        </DaysOfWeek>
        <Months>
            <January/>
            <February/>
            <March/>
            <April/>
            <May/>
            <June/>
            <July/>
            <August/>
            <September/>
            <October/>
            <November/>
            <December/>
        <Months>
    </ScheduleByMonthDayOfWeek>
</CalendarTrigger>

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]