Text/Tokens Surrounding each Holiday Name
At the bottom of the holidays (multiple) property editor, as shown on the right, are the the Text/Tokens Surrounding each Holiday Name settings, where you can specify text and/or tokens that should surround each holiday occurrence, if the processing of an individual holiday token generates multiple holidays.
•Usually, you should not include a LanguageTag and/or DayValue in the tokens that you place here. The LanguageTag and DayValue of the originating holiday name token will automatically be assumed. For example, if the original token was [6fa], then the use of [d] [ddd] [mmm] in the text surrounding the holiday name would be treated as [a6d] [a6ddd] [a6mmm].
•If you do specify a LanguageTag in the tokens here, then this LanguageTag will override the LanguageTag of the originating holiday name token.
•If you do specify a DayValue in the tokens here, then this DayValue will override the DayValue of the originating holiday name token.
•As always, any underscore character "_" (without the quotes) contained in this string will be replaced by a non-breaking space.
•You can use macro tokens.
•You can mix special character tokens with the tokens.
•You can use recursive tokens.
Overriding LanguageTags or DayValues
•If some of the tokens you wish to display here depend on language (such as the [ddd] and [mmm] tokens) you should use a LanguageTag in the original token, for example using [b6fa] as holiday token to ensure that the surrounding tokens get converted to [b6d] [b6ddd] [b6mmm].
•If you wish to use a different language than the language of the original token (for example c instead of b) then you must include a DayValue of 1 to your token, that is to say, use [c1ddd], instead of [ddd], for example.
•The same is true if you need to add a macro to the tokens before/after each holiday. In such cases, the DayValue 1 should be used, that is to say, the incorrect token [*2ddd] should instead be [1*2ddd], otherwise a run-time error message will be generated.
Using Holidays Tokens
You also can use holidays tokens in the text surrounding the holiday name.
•To avoid infinite recursion, this text is only added to occurrences of holidays from the original token. So, for example, if you had an [5fa] token that you wished to surround to the right by [fâ], the original occurrences of [5fa] would be surrounded on the right by [fâ], but that inserted [fâ] token would not in turn be surrounded on the right by another [fâ]token.
Clicking on the ellipsis button at the right of the left and right text fields, displays the dialog shown below, which is used to specify text and/or tokens surrounding each holiday occurrence, and, depending if the holiday lasts one or more days and, in the latter case, if that period is all in the same month or not (the idea is similar to MonthHeaders).
In these 3 fields that let you specify "combined" text and tokens sequences, you should:
•use the DayValue 000 to indicate the minimum date of the multiday holiday
•use the DayValue 999 to indicate the maximum date of the multiday holiday.
Other than the 2 specificities, above, you can fill these 3 fields as you would the Text/Tokens Surrounding each Holiday Name field, using the same rules for LanguageTags, macro tokens and special character tokens.
Note that, the text editor changes, as shown below, as soon as one of the 3 multiday fields is non-blank.