Standard Library procedure that creates the system variable !Weekend_List, which is used in calculating Date/Time compression.

day_names—A string or string array containing the weekend names.

None.

The result is stored in the system variable !Weekend_List, a seven-element integer array. The values in !Weekend_List are either ones or zeros, where 1 represents a weekend and 0 represents a weekday. The first element of !Weekend_List represents Sunday, and the last represents Saturday. !Weekend_List is used in calculating Date/Time compressions for functions that take the Compress keyword.

For instance, the routines DT_SUBTRACT, DT_ADD and DT_DURATION, can use the Compress keyword which, if set, excludes weekends from their results. In addition, the PLOT procedure uses the Compress keyword to remove weekends from a plot.

The values in the input string day_names must match or be a substring of strings in the !Day_Names system variable. By default, !Day_Names contains:

PRINT, !Day_Names

; PV-WAVE prints the following:

; Sunday Monday Tuesday Wednesday Thursday

; Friday Saturday

Thus, day_names = ['Sat', 'Sun'] is a valid assignment. If all days of the week are set to weekends, an error results.

; Defines Saturday as a weekend.

CREATE_WEEKENDS, 'Sat'

PRINT, !Weekend_List

; PV-WAVE prints: 0   0   0   0   0   0   1

The first element in the array !Weekend_List represents Sunday. The last represents Saturday. Weekend days have a value of 1.

CREATE_HOLIDAYS,   DT_COMPRESS,  LOAD_WEEKENDS