# <Scheduling>

The Scheduling element holds information about scheduled conversions. These options require version 3.35 or later of iSiloX and iSiloXC.

A given document entry can have zero, one, or multiple schedules for conversion. If an entry has one or more schedules for conversion then when a scheduled conversion is called upon for the conversion list file containing it, then its schedules are checked to see whether it is scheduled for conversion at that time. A schedule can be set to cause a conversion to happen once, hourly, daily, weekly, monthly, or always whenever a scheduled conversion occurs.

An example of where multiple schedules can come in handy is in the case of a news site that has daily, weekly, and monthly summaries of the corresponding period's most popular news articles. The daily schedule might be set to occur every weekday at 8PM, the weekly schedule might be set to occur every week on Saturday at 9AM, and the monthly schedule might be set to occur every month on the last day of the month at 10PM.

See Setting Up Schedules for more information on how to set up schedules.

## Full element example

        <Scheduling>
          <Disable                  value="no"/>
          <LastConversion>2003/03/11 16:23:02</LastConversion>
          <NextConversion>2003/03/12 15:17:00</NextConversion>
          <Schedules>
            <Schedule>
              <Disable              value="no"/>
              <LastConversion>2003/03/11 16:23:02</LastConversion>
              <NextConversion>2003/03/12 15:17:00</NextConversion>
              <Frequency            value="hourly"/>
              <Time                 value="17"/>
              <Weekday              value="Mon"/>
              <Day                  value="31"/>
              <Type                 value="every"/>
              <Every                value="1"/>
            </Schedule>
          </Schedules>
        </Scheduling>

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<Disable>` | value | no | Whether to disable scheduled conversions.
`<LastConversion>` | string | n/a | The date and time of the last scheduled conversion.
`<NextConversion>` | string | n/a | The date and time of the next scheduled conversion.
`<Schedules>` | container | n/a | Holds the scheduled conversion schedules.

## <Disable>

Description
Set the value attribute of the tag to `yes` to disable scheduled conversions of the document entry or `no` to enable them. If a document entry has no schedules, then it is never converted during a scheduled conversion.
Examples
This example specifies that scheduled conversions are disabled.

      <Disable                  value="yes"/>

This example specifies that scheduled conversions are enabled.

      <Disable                  value="no"/>

## <LastConversion>

Description
The content of the element specifies the date and time of the last scheduled conversion of the document. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.
Examples
This example specifies that the last scheduled conversion occurred on March 15, 2003 at 1:05PM.

      <LastConversion>2003/03/15 13:05:00</LastConversion>

This example specifies that the last scheduled conversion occurred on October 10, 2010 at 10:10AM.

      <LastConversion>2010/10/10 10:10:00</LastConversion>

## <NextConversion>

Description
The content of the element specifies the date and time of the next scheduled conversion for the document. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.

The next conversion date and time specified here should be the earliest next conversion date and time of all enabled schedules specified for the entry. Normally you do not set this element manually unless you want to override the next scheduled conversion date and time.

When iSiloX and iSiloXC perform a scheduled conversion, they check the next conversion date and time specified by this element. If the current date and time are at or after the specified next conversion date and time, then the entry is converted and the next conversion date and time is updated to the earliest next scheduled conversion date and time as determined by the schedules for the entry.
Examples
This example specifies that the next scheduled conversion will occur on April 1, 2003 at 1:05PM.

      <NextConversion>2003/04/01 13:05:00</NextConversion>

This example specifies that the next scheduled conversion will occur on October 10, 2010 at 10:10AM.

      <NextConversion>2010/10/10 10:10:00</NextConversion>

## <Schedules> sub-element summary

The Schedules container element holds the document's schedules for conversion. A document may have zero or more schedules, each represented by its own Schedule container sub-element within the Schedules container element. See below for example schedule specifications.

Tag | Type | Default | Description
--- | --- | --- | ---
`<Schedule>` | container | n/a | Holds information about a schedule.

### <Schedule> sub-element summary

The Schedule container element holds information about a schedule. It has the following sub-elements:

Tag | Type | Default | Description
--- | --- | --- | ---
`<Disable>` | value | no | Whether to disable the schedule.
`<LastConversion>` | string | n/a | The date and time of the last scheduled conversion.
`<NextConversion>` | string | n/a | The date and time of the next scheduled conversion.
`<StartDate>` | string | n/a | The starting date and time when the schedule is enabled.
`<EndDate>` | string | n/a | The date and time after which the schedule becomes disabled.
`<Frequency>` | value | n/a | How often to schedule a conversion.
`<Time>` | value | 0 | The time of the scheduled conversion.
`<Weekday>` | value | Mon | For weekly schedules, the weekday of the scheduled conversion.
`<Day>` | value | 1 | For monthly schedules, the day of the month for the scheduled conversion.
`<Type>` | value | every | Specifies periodic or chosen times.
`<Every>` | value | 1 | Specifies the periodic time interval.
`<Only>` | string | n/a | Specifies chosen times.

#### <Disable>

Description
Set the value attribute of the tag to `yes` to disable the schedule or `no` to enable it.
Examples
This example specifies that schedule is disabled.

      <Disable                  value="yes"/>

This example specifies that schedule is not disabled.

      <Disable                  value="no"/>

#### <LastConversion>

Description
The content of the element specifies the date and time of the last scheduled conversion of the document for the schedule containing this element. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.

If the NextConversion element for the schedule is missing, then the last conversion date and time as specified by the LastConversion element is used to determine when the next next scheduled conversion for the schedule should occur.
Examples
This example specifies that the last scheduled conversion for this schedule occurred on March 15, 2003 at 1:05PM.

      <LastConversion>2003/03/15 13:05:00</LastConversion>

This example specifies that the last scheduled conversion occurred on October 10, 2010 at 10:10AM.

      <LastConversion>2010/10/10 10:10:00</LastConversion>

#### <NextConversion>

Description
The content of the element specifies the date and time of the next scheduled conversion for the schedule containing this element. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.

Normally you do not set this element manually unless you want to override the next scheduled conversion date and time for the schedule.

After iSiloX and iSiloXC perform a scheduled conversion for a schedule, the next conversion element of the schedule is updated to the next scheduled conversion date and time. For example, if a schedule specifies a daily conversion frequency that is to occur every day at 10:00AM, then if today is March 15, 2003 and the time is 10:00AM, and a scheduled conversion occurs, then the next scheduled conversion is updated to be on March 16, 2003 at 10:00AM.
Examples
This example specifies that the next scheduled conversion for the schedule will occur on March 16, 2003 at about 10:00AM.

      <NextConversion>2003/03/16 10:00:00</NextConversion>

This example specifies that the next scheduled conversion for the schedule will occur on October 10, 2010 at 10:10AM.

      <NextConversion>2010/10/10 10:10:00</NextConversion>

#### <StartDate>

Description
The content of the element specifies the date and time when the schedule first takes effect. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.

The first scheduled conversion using the schedule containing this element does not occur until at or after the specified start date and time. A schedule that does not specify a start date and time is immediately in effect.

For a one-time scheduled conversion, the StartDate element gives the date and time of the one-time scheduled conversion.
Examples
This example specifies that the schedule does not take effect until June 10, 2003 at 12:00AM.

      <StartDate>2003/06/10 00:00:00</StartDate>

#### <EndDate>

Description
The content of the element specifies the absolute last date and time that the schedule will be active. The date and time are in the form YYYY/MM/DD HH:MM:SS, where YYYY/MM/DD is the year, month, and day and HH:MM:SS is the hour, minute, and second, and are interpreted as local time.

After the end date and time have been reached, scheduled conversions according to the schedule containing this element no longer occur. A schedule that does not specify an end date and time remains in effect indefinitely.
Examples
This example specifies that scheduled conversions according to the schedule containing this element no longer occur after July 2, 2003 at 11:30PM.

      <EndDate>2003/07/02 23:30:00</EndDate>

#### <Frequency>

Description
Set the value attribute of the tag to one of the following values to specify the schedule frequency:

- once: Schedule for conversion only one time
- hourly: Schedule for conversion hourly
- daily: Schedule for conversion daily
- weekly: Schedule for conversion weekly
- monthly: Schedule for conversion monthly
- always: Convert whenever a scheduled conversion occurs

See Setting Up Schedules below for more information and detailed examples.
Examples
This example schedules a one-time scheduled conversion.

      <Frequency                value="once">

This example schedules an hourly scheduled conversion.

      <Frequency                value="hourly">

This example schedules a daily scheduled conversion.

      <Frequency                value="daily">

This example schedules a weekly scheduled conversion.

      <Frequency                value="weekly">

This example schedules a monthly scheduled conversion.

      <Frequency                value="monthly">

This example specifies that the document should be converted anytime there is a scheduled conversion.

      <Frequency                value="always">

#### <Time>

Description
For an hourly schedule, set the value attribute of the tag to the number of minutes after the hour at which to perform the conversion. For daily, weekly, and monthly schedules, set the value attribute of the tag to the time of day at which to perform the conversion. Use the form HHMM to specify the time of day, where HH is the hour and MM is the minute.
Examples
For an hourly schedule, the following example schedules the conversion to occur 18 minutes after the hour.

      <Time                     value="18">

For a daily, weekly, or monthly schedule, the following example schedules the conversion to occur at 1:20PM.

      <Time                     value="1320">

#### <Weekday>

Description
The Weekday element applies only to weekly schedules. Set the value attribute of the tag to the weekday on which to schedule the conversion. The weekday is specified using the weekday's three letter abbreviation:

- Mon: Monday
- Tue: Tuesday
- Wed: Wednesday
- Thu: Thursday
- Fri: Friday
- Sat: Saturday
- Sun: Sunday

Examples
For a weekly schedule, the following example schedules the conversion to occur on Monday.

      <Weekday                  value="Mon">

For a weekly schedule, the following example schedules the conversion to occur on Saturday.

      <Weekday                  value="Sat">

#### <Day>

Description
The Day element applies only to monthly schedules. Set the value attribute of the tag to the day of the month on which to schedule the conversion. To schedule the conversion for the last day of the month, specify 31.
Examples
For a monthly schedule, the following example schedules the conversion to occur on the first day of the month.

      <Day                      value="1">

For a monthly schedule, the following example schedules the conversion to occur on the tenth day of the month.

      <Day                      value="10">

For a monthly schedule, the following example schedules the conversion to occur on the last day of the month.

      <Day                      value="31">

#### <Type>

Description
This element applies only to hourly, daily, weekly, and monthly schedules. Set the value atribute of the tag to one of the following values:

- every: Specifies that scheduled conversions are to occur at regular intervals of the frequency period. Use the Every element to specify the interval.
- only: Specifies that scheduled conversions are to occur only during certain periods. Use the Only element to specify the periods.

Examples
For an hourly schedule, the following example schedules the conversion to occur every two hours.

      <Type                     value="every">
      <Every                    value="2">

Examples
For a monthly schedule, the following example schedules the conversion to occur only in March and June.

      <Type                     value="only">
      <Only>3,6</Only>

#### <Every>

Description
This element applies only to hourly, daily, weekly, and monthly schedules when the value attribute of the Type element is set to `every`. For an hourly schedule, set the value attribute of the tag to the number of hours between conversions. For a daily schedule, set the value attribute of the tag to the number of days between conversions. For a weekly schedule, set the value attribute of the tag to the number of weeks between conversions. For a monthly schedule, set the value attribute of the tag to the number of monthly between conversions.
Examples
For an hourly schedule, the following example schedules the conversion to occur once every hour.

      <Type                     value="every">
      <Every                    value="1">

For a daily schedule, the following example schedules the conversion to occur once every five days.

      <Type                     value="every">
      <Every                    value="5">

For a weekly schedule, the following example schedules the conversion to occur once every two weeks.

      <Type                     value="every">
      <Every                    value="2">

For a monthly schedule, the following example schedules the conversion to occur once every three months.

      <Type                     value="every">
      <Every                    value="3">

#### <Only>

Description
This element applies only to hourly, daily, weekly, and monthly schedules when the value attribute of the Type element is set to `only`.

For an hourly schedule, set the element content to a comma-separated list of the hours of the day during which to schedule a conversion. The hours of the day are represented by the numbers 0 through 23 as follows:

- 0: 12:00 AM
- 1: 1:00 AM
- 2: 2:00 AM
- 3: 3:00 AM
- 4: 4:00 AM
- 5: 5:00 AM
- 6: 6:00 AM
- 7: 7:00 AM
- 8: 8:00 AM
- 9: 9:00 AM
- 10: 10:00 AM
- 11: 11:00 AM
- 12: 12:00 PM
- 13: 1:00 PM
- 14: 2:00 PM
- 15: 3:00 PM
- 16: 4:00 PM
- 17: 5:00 PM
- 18: 6:00 PM
- 19: 7:00 PM
- 20: 8:00 PM
- 21: 9:00 PM
- 22: 10:00 PM
- 23: 11:00 PM

For a daily schedule, set the element content to a comma-separated list of the days of the week during which to schedule a a conversion. The days of the week are specified using their three letter abbreviations:

- Mon: Monday
- Tue: Tuesday
- Wed: Wednesday
- Thu: Thursday
- Fri: Friday
- Sat: Saturday
- Sun: Sunday

For a weekly schedule, set the element content to a comma-separated list of the weeks of the month during which to schedule a conversion. The weeks of the month are represented by the numbers 1 through 5 as follows:

- 1: First week of the mont
- 2: Second week of the mont
- 3: Third week of the mont
- 4: Fourth week of the mont
- 5: Last week of the month

For a monthly schedule, set the element content to a comma-separated list of the months of the year during which to schedule a conversion. The months of the year are represented by the numbers 1 through 12 as follows:

- 1: January
- 2: February
- 3: March
- 4: April
- 5: May
- 6: June
- 7: July
- 8: August
- 9: September
- 10: October
- 11: November
- 12: December

Examples
For an hourly schedule, the following example schedules the conversion to occur only at 3PM, 10PM, and 12AM.

      <Type                     value="only">
      <Only>15,22,0</Only>

For a daily schedule, the following example schedules the conversion to occur only on Monday and Friday.

      <Type                     value="only">
      <Only>Mon,Fri</Only>

For a weekly schedule, the following example schedules the conversion to occur only on the first and last weeks of the month.

      <Type                     value="only">
      <Only>1,5</Only>

For a monthly schedule, the following example schedules the conversion to occur only in January, May, July, and September.

      <Type                     value="only">
      <Only>1,5,7,9</Only>

## Setting Up Schedules

This section provides more information and complete examples of the different schedule types.

### One-time schedules

A one-time scheduled conversion occurs once at a specified date and time. To set up a one-time schedule do the following:

1. Set the value attribute of the Frequency tag to `once`.
2. Specify the date and time of the conversion using the StartDate element.

Examples
This example schedules a one-time conversion to occur on June 10, 2003 at 12:00AM.

      <Schedule>
        <Frequency              value="once">
        <StartDate>2003/06/10 00:00:00</StartDate>
      </Schedule>

This example schedules a one-time conversion to occur on May 29, 2005 at 2:18PM.

      <Schedule>
        <Frequency              value="once">
        <StartDate>2005/05/29 14:18:00</StartDate>
      </Schedule>

### Hourly schedules

An hourly scheduled conversion occurs at a specified number of minutes after the hour once every specified number of hours or at chosen hours of the day. An hourly schedule can also have an effective start and/or end date and time. To set up an hourly schedule, do the following:

1. Set the value attribute of the Frequency tag to `hourly`.
2. Set the value attribute of the Time tag to the number of minutes after the hour at which to schedule the conversion.
3. To have the conversion performed once every given number of hours, set the value attribute of the Type tag to `every` and specify the hourly interval in the value attribute of the Every tag.
4. To have the conversion performed only at given hours of the day, set the value attribute of the Type tag to `only` and provide a comma-separated list of the hours of the day in the content of the Only element.
5. To have the schedule take effect starting from a given date and time, specify the date and time in the content of the StartDate element.
6. To have the schedule no longer active after a given date and time, specify the ending date and time in the content of the EndDate element.

Examples
This example schedules conversions to occur every hour at the beginning of the hour.

      <Schedule>
        <Frequency              value="hourly">
      </Schedule>

This example schedules conversions to occur every hour at 15 minutes after the hour.

      <Schedule>
        <Frequency              value="hourly">
        <Time                   value="15">
      </Schedule>

This example schedules conversions to occur every six hours at the beginning of the hour.

      <Schedule>
        <Frequency              value="hourly">
        <Type                   value="every">
        <Every                  value="6">
      </Schedule>

This example schedules conversions to occur every eight hours at fifty minutes after the hour.

      <Schedule>
        <Frequency              value="hourly">
        <Time                   value="50">
        <Type                   value="every">
        <Every                  value="8">
      </Schedule>

This example schedules conversions to occur only at 1PM, 3PM, and 4PM.

      <Schedule>
        <Frequency              value="hourly">
        <Type                   value="only">
        <Only>13,15,16</Only>
      </Schedule>

This example schedules conversions to occur only at 6:30AM and 8:30PM.

      <Schedule>
        <Frequency              value="hourly">
        <Time                   value="30">
        <Type                   value="only">
        <Only>6,20</Only>
      </Schedule>

This example schedules conversions to occur every hour at 59 minutes after the hour starting from June 3, 2003.

      <Schedule>
        <Frequency              value="hourly">
        <Time                   value="59">
        <StartDate>2003/06/03 00:00:00</StartDate>
      </Schedule>

This example schedules conversions to occur every hour at the beginning of the hour until and including October 31, 2003 at 5PM.

      <Schedule>
        <Frequency              value="hourly">
        <EndDate>2003/10/31 17:00:00</EndDate>
      </Schedule>

This example schedules conversions to occur every hour at the beginning of the hour only from December 20, 2003 at 2AM to December 30, 2003 at 1AM.

      <Schedule>
        <Frequency              value="hourly">
        <StartDate>2003/12/20 02:00:00</StartDate>
        <EndDate>2003/12/30 01:00:00</EndDate>
      </Schedule>

### Daily schedules

A daily scheduled conversion occurs at a specified time of the day once every specified number of days or on chosen days of the week. A daily schedule can also have an effective start and/or end date and time. To set up a daily schedule, do the following:

1. Set the value attribute of the Frequency tag to `daily`.
2. Set the value attribute of the Time tag to the time of the day at which to schedule the conversion.
3. To have the conversion performed once every given number of days, set the value attribute of the Type tag to `every` and specify the daily interval in the value attribute of the Every tag.
4. To have the conversion performed only on given days of the week, set the value attribute of the Type tag to `only` and provide a comma-separated list of the days of the week in the content of the Only element.
5. To have the schedule take effect starting from a given date and time, specify the date and time in the content of the StartDate element.
6. To have the schedule no longer active after a given date and time, specify the ending date and time in the content of the EndDate element.

Examples
This example schedules conversions to occur every day at 12AM.

      <Schedule>
        <Frequency              value="daily">
      </Schedule>

This example schedules conversions to occur every day at 8:15AM.

      <Schedule>
        <Frequency              value="daily">
        <Time                   value="0815">
      </Schedule>

This example schedules conversions to occur every five days at 12AM.

      <Schedule>
        <Frequency              value="daily">
        <Type                   value="every">
        <Every                  value="5">
      </Schedule>

This example schedules conversions to occur every six days at 3:08PM.

      <Schedule>
        <Frequency              value="daily">
        <Time                   value="1508">
        <Type                   value="every">
        <Every                  value="6">
      </Schedule>

This example schedules conversions to occur only on Monday, Wednesday, and Friday at 12AM.

      <Schedule>
        <Frequency              value="daily">
        <Type                   value="only">
        <Only>Mon,Wed,Fri</Only>
      </Schedule>

This example schedules conversions to occur only Saturday and Sunday at 6:00AM.

      <Schedule>
        <Frequency              value="daily">
        <Time                   value="0600">
        <Type                   value="only">
        <Only>Sat,Sun</Only>
      </Schedule>

This example schedules conversions to occur every day at 9:10AM starting from July 4, 2003.

      <Schedule>
        <Frequency              value="daily">
        <Time                   value="0910">
        <StartDate>2003/07/04 00:00:00</StartDate>
      </Schedule>

This example schedules conversions to occur every day at 12AM until and including September 1, 2003 at 12AM.

      <Schedule>
        <Frequency              value="daily">
        <EndDate>2003/09/01 00:00:00</EndDate>
      </Schedule>

This example schedules conversions to occur every day at 1:20AM from November 13, 2003 12AM to November 17, 2003 12AM. Note that the last scheduled conversion will actually be November 16 at 1:20AM, since the time 1:20AM of the following day is after the end date and time of November 17, 2003 12AM.

      <Schedule>
        <Frequency              value="daily">
        <Time                   value="0120">
        <StartDate>2003/11/13 00:00:00</StartDate>
        <EndDate>2003/11/17 00:00:00</EndDate>
      </Schedule>

### Weekly schedules

A weekly scheduled conversion occurs at a specified time of a specified day of the week once every specified number of weeks or on chosen weeks of the month. A weekly schedule can also have an effective start and/or end date and time. To set up a weekly schedule, do the following:

1. Set the value attribute of the Frequency tag to `weekly`.
2. Set the value attribute of the Time tag to the time of the day at which to schedule the conversion.
3. Set the value attribute of the Weekday tag to the day of the week on which to schedule the conversion.
4. To have the conversion performed once every given number of weeks, set the value attribute of the Type tag to `every` and specify the weekly interval in the value attribute of the Every tag.
5. To have the conversion performed only on given weeks of the month, set the value attribute of the Type tag to `only` and provide a comma-separated list of the weeks of the month in the content of the Only element.
6. To have the schedule take effect starting from a given date and time, specify the date and time in the content of the StartDate element.
7. To have the schedule no longer active after a given date and time, specify the ending date and time in the content of the EndDate element.

Examples
This example schedules conversions to occur every week on Monday at 12AM.

      <Schedule>
        <Frequency              value="weekly">
      </Schedule>

This example schedules conversions to occur every week on Monday at 3:05PM.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="1505">
      </Schedule>

This example schedules conversions to occur every week on Thursday at 5:11PM.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="1711">
        <Weekday                value="Thu">
      </Schedule>

This example schedules conversions to occur every two weeks on Monday at 12AM.

      <Schedule>
        <Frequency              value="weekly">
        <Type                   value="every">
        <Every                  value="2">
      </Schedule>

This example schedules conversions to occur every three weeks on Tuesday at 7:00AM.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="0700">
        <Weekday                value="Tue">
        <Type                   value="every">
        <Every                  value="3">
      </Schedule>

This example schedules conversions to occur only on the first and last weeks of the month on Friday at 12AM.

      <Schedule>
        <Frequency              value="weekly">
        <Weekday                value="Fri">
        <Type                   value="only">
        <Only>1,5</Only>
      </Schedule>

This example schedules conversions to occur only on the second and fourth weeks of the month on Monday at 5:45AM.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="0545">
        <Type                   value="only">
        <Only>2,4</Only>
      </Schedule>

This example schedules conversions to occur every week on Monday at 8:53AM starting from August 29, 2003.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="0853">
        <StartDate>2003/08/29 00:00:00</StartDate>
      </Schedule>

This example schedules conversions to occur every week on Monday at 12AM until and including June 30, 2003 at 12AM.

      <Schedule>
        <Frequency              value="weekly">
        <EndDate>2003/06/30 00:00:00</EndDate>
      </Schedule>

This example schedules conversions to occur every week on Saturday at 1:14PM from December 1, 2003 12AM to January 31, 2004 12AM. Note that the last scheduled conversion will actually be January 27, 2004 at 1:14PM, since the time 1:14PM of the following Monday is after the end date and time of January 31, 2004 12AM.

      <Schedule>
        <Frequency              value="weekly">
        <Time                   value="1314">
        <Weekday                value="Sat">
        <StartDate>2003/12/01 00:00:00</StartDate>
        <EndDate>2004/01/31 00:00:00</EndDate>
      </Schedule>

### Monthly schedules

A monthly scheduled conversion occurs at a specified time of a specified day of the month once every specified number of months or on chosen months of the year. A monthly schedule can also have an effective start and/or end date and time. To set up a monthly schedule, do the following:

1. Set the value attribute of the Frequency tag to `monthly`.
2. Set the value attribute of the Time tag to the time of the day at which to schedule the conversion.
3. Set the value attribute of the Day tag to the day of the month on which to schedule the conversion.
4. To have the conversion performed once every given number of months, set the value attribute of the Type tag to `every` and specify the monthly interval in the value attribute of the Every tag.
5. To have the conversion performed only on given months of the year, set the value attribute of the Type tag to `only` and provide a comma-separated list of the months of the year in the content of the Only element.
6. To have the schedule take effect starting from a given date and time, specify the date and time in the content of the StartDate element.
7. To have the schedule no longer active after a given date and time, specify the ending date and time in the content of the EndDate element.

Examples
This example schedules conversions to occur every month on the first day of the month at 12AM.

      <Schedule>
        <Frequency              value="monthly">
      </Schedule>

This example schedules conversions to occur every month on the first day of the month at 6:39PM.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="1839">
      </Schedule>

This example schedules conversions to occur every month on the tenth day of the month at 9:30AM.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="0930">
        <Day                    value="10">
      </Schedule>

This example schedules conversions to occur every three months on the first day of the month at 12AM.

      <Schedule>
        <Frequency              value="monthly">
        <Type                   value="every">
        <Every                  value="3">
      </Schedule>

This example schedules conversions to occur every five months on the 21st day of the month at 6:00AM.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="0600">
        <Day                    value="21">
        <Type                   value="every">
        <Every                  value="5">
      </Schedule>

This example schedules conversions to occur only on January and February on the last day of the month at 12AM.

      <Schedule>
        <Frequency              value="monthly">
        <Day                    value="31">
        <Type                   value="only">
        <Only>1,2</Only>
      </Schedule>

This example schedules conversions to occur only on February, October, and November on the first day of the month at 6:51AM.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="0651">
        <Type                   value="only">
        <Only>2,10,11</Only>
      </Schedule>

This example schedules conversions to occur every month on the first day of the month at 10:11AM starting from November 9, 2003.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="1011">
        <StartDate>2003/11/09 00:00:00</StartDate>
      </Schedule>

This example schedules conversions to occur every month on the first day of the month at 12AM until and including December 1, 2003 at 12AM.

      <Schedule>
        <Frequency              value="monthly">
        <EndDate>2003/12/01 00:00:00</EndDate>
      </Schedule>

This example schedules conversions to occur every month on the 25th day of the month at 8:38PM from December 1, 2003 12AM to December 1, 2004 12AM. Note that the first scheduled conversion will occur on December 25, 2003 and the last scheduled conversion will occur on November 25, 2004 at 8:38PM.

      <Schedule>
        <Frequency              value="monthly">
        <Time                   value="2038">
        <Day                    value="25">
        <StartDate>2003/12/01 00:00:00</StartDate>
        <EndDate>2004/12/01 00:00:00</EndDate>
      </Schedule>

### Always schedules

In addition to being able to specify schedules that only happen once and at regular intervals, you can specify a special schedule that results in conversion whenever the scheduled conversion of any other entry occurs. This is known as an always schedule. To set up an always schedule, do the following:

1. Set the value attribute of the Frequency tag to `always`.
2. To have the schedule take effect starting from a given date and time, specify the date and time in the content of the StartDate element.
3. To have the schedule no longer active after a given date and time, specify the ending date and time in the content of the EndDate element.

Examples
This example schedules conversions to occur whenever any other document entry has a scheduled conversion that occurs.

      <Schedule>
        <Frequency              value="always">
      </Schedule>

This example schedules conversions to occur whenever any other document entry has a scheduled conversion that occurs from February 1, 2004 at 2AM to March 3, 2004 at 12AM.

      <Schedule>
        <Frequency              value="always">
        <StartDate>2004/02/01 02:00:00</StartDate>
        <EndDate>2004/03/03 00:00:00</EndDate>
      </Schedule>

## Multiple schedules example

The following is an example of multiple schedules specified for a single document entry. It represents the example described above where a news site has daily, weekly, and monthly summaries of the corresponding period's most popular news articles. The daily scheduled conversion occurs every weekday, Monday through Friday, at 8PM, the weekly scheduled conversion occurs every week on Saturday at 9AM, and the monthly scheduled conversion occurs every month on the last day of the month at 10PM.

        <Scheduling>
          <Schedules>
            <Schedule>
              <Frequency            value="daily"/>
              <Time                 value="2000"/>
              <Type                 value="only">
              <Only>Mon,Tue,Wed,Thu,Fri</Only>
            </Schedule>
            <Schedule>
              <Frequency            value="weekly"/>
              <Time                 value="0900"/>
              <Weekday              value="Sat"/>
            </Schedule>
            <Schedule>
              <Frequency            value="monthly"/>
              <Time                 value="2200"/>
              <Day                  value="31"/>
            </Schedule>
          </Schedules>
        </Scheduling>

©1999-2017 DC & Co. All rights reserved.