Variable Holiday Names

Navigation:  Holidays > Recurring Holidays > Name >

Variable Holiday Names

Previous pageReturn to chapter overviewNext page

You can have the names of your recurring holidays change depending on the circumstances of each holiday date generated from the current holidays rule.

 

The variability is specified by the inclusion of one or more lines, below the holiday's "default" name (the text on the first row of the holiday name textbox into the holiday name variation), which begin with >>> followed by one of the keywords, and equal sign and then the name to use if the keyword applies.

 

you can use the token <hol> to include the default holiday name.

you can use the token <DELETE> to indicate that the occurrence of the holiday that matches a particular keyword should be deleted.

 

The allowed keywords are:

DUP

The DUP keyword specifies the name to use for any "duplicated" date (corresponding to the also occur on setting of the Weekdays options of holidays recurrence rules). For example, if Australia Day falls on a Sunday, then the following Monday is a public holiday in Australia but, of course, one would not call that day Australia Day. In the example here we chose to call it Australia Day Holiday.

 

Using <DELETE> as part of any holiday variation will ensure that dates covered by that variation are not generated. For example, using >>>DUP=<DELETE> on a holiday with Sunday duplicated on Monday would mean that the dates corresponding to these days in lieu are not generated.

BASE

The BASE keyword specifies the name to use for the base date of a holiday which has been duplicated (see DUP option above). In the example on the left, both the Boxing Day holiday and the 1st day of Stanley Races are set on December 26, except when December 26 is a Saturday, Sunday or Monday, in which case the Stanley Races move to the next working day (via the DUP keyword) while Boxing Day remains fixed on December 26 (via the BASE keyword).

MOV

The MOV keyword specifies the name to use for any "moved" date (corresponding to the are moved to setting of the Weekdays options of holidays recurrence rules). For example, in Colombia the Saint Joseph Day bank holiday, normally on March 19, is moved to the nearest Monday if it falls on any other weekday, and in such cases calling that bank holiday as Saint Joseph Day would be wrong, so we use a holiday name variation to have its name changed to Saint Joseph's Day Holiday.

DAY

The DAY keyword is useful for multiple day events.

 

The DAY keyword, when followed by a number indicates that a specific variation of the name should occur on the specified day of a multi-day holiday (eg. DAY2 would apply to the second day only of a multi-day holiday).

 

The DAY keyword can also be followed by a tilde and a number to indicate that a specific variation of the name should occur on all days except the specified day of a multi-day holiday (eg. DAY~1 would apply to all days of a holiday except the first day).

0

When the keyword is a single digit from 1-7, then it specifies the name to use in the case of the holiday falling on a given day of the week (Monday=1, ..., Sunday=7).

 

In the example on the left, the holiday is a full day holiday when it falls on a Monday (>>>1), and is only a half-day afternoon holiday when it falls on a Friday (>>>5).

00

When the keyword is a double-digit from 01-31, then it specifies the name to use in the case of the holiday falling on a given day of the month (from 1-31).

 

In the example on the left, the holiday is observed on the 3rd Monday in August. But, as the anniversary being commemorated was August 17, we want to change the name when the holidays falls on the 17th of August.

0000

When the keyword is a four-digit from 2000-9999, then it specifies the name to use for all occurrences of a holiday in a given calendar year. In the example on the left, the holiday in 2011 is renamed as the 30th Anniversary of Independence, something that will only occur in 2011.

 

Note that you can add a + or - to the 4 digits to indicate that the change occurs for the given year and all future years (eg. 2011+), or for the given year and all years before (eg. 2011-).

 

You can also specify a range of years using 2 dots (..) to separate the beginning year from the end year (eg. 2011..2014).

 

The DUP and MOV keywords can also be added to any of the 4-digit keywords, including the range of years. For example: 2011+_DUP or 2012_MOV.

DEFAULT

Use the DEFAULT keyword to specify the name of the holiday when none of the special cases apply.

 

In the example on the left, the use of the DEFAULT keyword allows us to remove the usual (except CT) from the name of the holiday, so that the 2010, 2014, 2015, and 2017 exceptions can use the <hol> token. Without the DEFAULT keyword entry, the full name of the holiday, minus the usual (except CT), would have had to be written out every line (for example >>>2017=Maundy Thursday (except CT VC) ).

 

In the example to the left, the DEFAULT entry is the very first one, and it makes sense, for the sake of legibility, to place it there, but there is no technical requirement that the DEFAULT entry should be the very first one; it can be placed in any position.

 

See also: Holiday Name Filtering Tokens.


Topic 178620 updated on 09-Jun-2017.
Topic URL: http://www.qppstudio.net/webhelp/index.html?variable_holiday_names.htm