Skip to content

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

Type: 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

Type: 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

Type: 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

Type: 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

Type: 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

Type: 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: