SCHEDULE Element

---

Defines the schedule used for channel updating.

Syntax

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

Attributes

ENDDATE

Obsolete. Do not use. This attribute has been replaced by STOPDATE.

STARTDATE

Numeric value specifying the 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

Numeric value specifying the 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

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.

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

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.

Element Information

Number of occurrences	None or one per CDF file (top-level channel only)
Parent elements	CHANNEL
Child elements	EARLIESTTIME, INTERVALTIME, LATESTTIME
File formats supported	CDF
Requires closing tag	Yes

Remarks

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.

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.

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 August 17, 1999.

<SCHEDULE STOPDATE="1999-08-17"> 
    <INTERVALTIME DAY="1"/>
    <EARLIESTTIME HOUR="12"/>
    <LATESTTIME HOUR="18"/>
</SCHEDULE>