You can have the names of your recurring holidays change depending on the circumstances of each holidays 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.
The allowed keywords are (you can use <hol> to include the default holiday name):
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. |
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-).
The DUP and MOV keywords can also be added to the 4-digit keyword. For example: 2011+_DUP or 2012_MOV. |
See also: Holiday Name Filtering Tokens.