4.2 HOLIDAY

HOLIDAY objects define holidays. Holidays have no inherent effect, but input expressions can test for holidays via the $DOWH, $isHoliday, $isHoliTrue, $isWeHol, and $isBegWeek system variables (4.6.4).

Examples and the list of default holidays are given after the member descriptions.

hdName

Name of holiday: must follow the word HOLIDAY.

Units	Legal Range	Default	Required	Variability
	63 characters	none	Yes	constant

A holiday may be specified by date or via a rule such as “Fourth Thursday in November”. To specify by date, give hdDateTrue, and also hdDateObs or hdOnMonday if desired. To specify by rule, give all three of hdCase, hdMon, and hdDow.

hdDateTrue=date

The true date of a holiday, even if not celebrated on that day.

Units	Legal Range	Default	Required	Variability
	date	blank	No	constant

hdDateObs=date

The date that a holiday will be observed. Allowed only if hdDateTrue given and hdOnMonday not given.

Units	Legal Range	Default	Required	Variability
	date	hdDateTrue	No	constant

hdOnMonday=choice

If YES, holiday is observed on the following Monday if the true date falls on a weekend. Allowed only if hdDateTrue given and hdDateObs not given.

Note: there is no provision to celebrate a holiday that falls on a Saturday on Friday (as July 4 was celebrated in 1992).

Units	Legal Range	Default	Required	Variability
	YES/NO	YES	No	constant

hdCase=choice

Week of the month that the holiday is observed. hdCase, hdMon, and hdDow may be given only if hdDateTrue, hdDateObs, and hdOnMonday are not given.

Units	Legal Range	Default	Required	Variability
	FIRST SECOND THIRD FOURTH LAST	FIRST	No	constant

hdMon=choice

Month that the holiday is observed.

Units	Legal Range	Default	Required	Variability
	JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC	none	required if hdCase given	constant

hdDow=choice

Day of the week that the holiday is observed.

Units	Legal Range	Default	Required	Variability
	SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY	MONDAY	required if hdCase given	constant

endHoliday

Indicates the end of the holiday definition. Alternatively, the end of the holiday definition can be indicated by “END” or simply by beginning another object.

Units	Legal Range	Default	Required	Variability
			none	constant

Examples of valid HOLIDAY object specifications:

• Holiday on May first, observed date moved to following Monday if the first falls on a weekend (hdOnMonday defaults Yes).

    HOLIDAY MAYDAY;
        hdDateTrue = May 1;

• Holiday on May 1, observed on May 3.

    HOLIDAY MAYDAY;
        hdDateTrue = May 1;
        hdDateObs  = May 3;

• Holiday observed on May 1 even if on a weekend.

    HOLIDAY MAYDAY;
        hdDateTrue = May 1;
        hdOnMonday = No;

• Holiday observed on Wednesday of third week of March

    HOLIDAY HYPOTHET;
        hdCase = third;
        hdDow  = Wed;
        hdMon  = MAR

As with reports, Holidays are automatically generated for a standard set of Holidays. The following are the default holidays automatically defined by CSE:

New Year’s Day	*January 1
M L King Day	*January 15
President’s Day	3rd Monday in February
Memorial Day	last Monday in May
Fourth of July	*July 4
Labor Day	1st Monday in September
Columbus Day	2nd Monday in October
Veterans Day	*November 11
Thanksgiving	4th Thursday in November
Christmas	*December 25

* observed on the following Monday if falls on a weekend, except as otherwise noted:

If a particular default holiday is not desired, it can be removed with a DELETE statement:

    DELETE HOLIDAY Thanksgiving

    DELETE HOLIDAY "Columbus Day"  // Quotes necessary (due to space)

    DELETE HOLIDAY "VETERANS DAY"  // No case-sensitivity

Note that the name must be spelled exactly as listed above.

Related Probes:

• @holiday