SCHEDULESCHEDULE*
*



Contents  *



Index  *Topic Contents

*Previous Topic: PURGETIME
*Next Topic: TITLE

SCHEDULE

<SCHEDULE
STARTDATE="date"
STOPDATE="date"
TIMEZONE="offset"
>

Defines the schedule used for channel updating. Starting at midnight on STARTDATE, channel updating occurs once within each consecutive time interval specified by the INTERVALTIME child element. The EARLIESTTIME and LATESTTIME child elements specify offsets that define the valid range of time within each interval that channel updates can occur.

The schedule must be placed directly under the top-level channel element, and it must contain a nonzero INTERVALTIME value to be considered valid. This schedule is relative to the time zone in TIMEZONE, if present; otherwise, the schedule is relative to the local time of the user. This schedule applies to the channel only if the user accepts the default "publisher's recommended schedule" when subscribing to the channel. Additional information on scheduled updates is available in the Creating Active Channels documentation.

This element should appear near the top of the CDF file, after the top-level CHANNEL element and before any ITEM or nested CHANNEL elements.

ENDDATE="date"
Obsolete. Do not use. This attribute has been replaced by STOPDATE.
STARTDATE="date"
Day on which the schedule will start to apply. If this attribute is omitted, the schedule will start to apply on the current day. The date for this attribute is specified in the form yyyy-mm-dd, where:
yyyy Specifies the year.
mm Specifies the month (01-12).
dd Specifies the day of the month (01-31).
STOPDATE="date"
Day on which the schedule stops updating (expires). If this attribute is omitted, the schedule will not expire. The date for this attribute is specified in the form yyyy-mm-dd, where:
yyyy Specifies the year.
mm Specifies the month (01-12).
dd Specifies the day of the month (01-31).
TIMEZONE="offset"
Difference between local time and Universal Time Coordinated (UTC). This allows channel publishers to specify an absolute time for an update schedule. The offset specified for this attribute adjusts the EARLIESTTIME and LATESTTIME child elements accordingly. The date for this attribute is specified in the form szzzz, where:
s Specifies the relationship of the local time to UTC. A minus (-) or plus (+) sign is used to indicate whether the local time is earlier or later than UTC.
zzzz Specifies the offset from UTC in hours and minutes.

Number of allowed occurrences: None or one (top-level channel only)
Parent elements Child elements
CHANNEL EARLIESTTIME
ITEM INTERVALTIME
LATESTTIME

The end tag </SCHEDULE> is required.

For example, to specify the U.S. Eastern Standard Time (EST), which is 5 hours earlier than UTC, use: TIMEZONE="-0500".

Example

The following example shows a schedule that takes effect immediately and updates the channel once per day, sometime between noon and 6 P.M. The channel will stop receiving updates on December 1, 1997.

<SCHEDULE ENDDATE="1997-12-01"> 
    <INTERVALTIME DAY="1"/>
    <EARLIESTTIME HOUR="12"/>
    <LATESTTIME HOUR="18"/>
</SCHEDULE>


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.