str = GetHolNameFromTable()

This macro function returns the name of the current holiday in the holidays table.

➢The current holiday in the holidays table is due to previous calls to functions which move the cursor in the holidays table, such as FindNextHolidayOnDate and GetNextDateForHolidayId.

If you only need to get the plain text part of a holiday name, for example to see if it contains some given text, then you should use the GetHolTextFromTable function instead.

Observances Included in the Holiday Name

A recurring holiday's observance is usually set in the holidays manager's user interface. However, it is also possible to specify the observance of each generated holiday using observance labels in the names or name variations of recurring holidays as well as the name of one-time-dates.

By default, this function moves any such observance markers from the name obtained from this function and includes them in the result of the function GetHolObservanceFromTable.

If you do not wish to have any observance markers removed from the holiday name returned by the function GetHolNameFromTable, then use the ignore observance option to have a specific holiday be treated as a holiday with no observance, in all respects, except for holidays synchronization and the names of one-time dates whose observance labels are always processed.

Formatted Holiday Names

If the name of the holiday does not contain any formatting, such as bold, italics, underline, then calling GetHolNameFromTable() will have the same result as calling GetHolTextFromTable(false).

If, however, the name of the holiday contains any formatting, as in the example above, then as is the case when using the FormatParagraph and FormatText, the result of a call to the function GetHolNameFromTable will look like '**RICH1**except WA & QLD**TEXT1**' with a command is saved for later processing, to replace the string '**RICH1**except WA & QLD**TEXT1**' with 'except WA & QLD' in the italics formatting specified above.

If you wish to specify that the italics or bold portion of the holiday name use a specific font (rather than simply applying electronic italics or bold), or if you are using InDesign, then you should use the function GetHolNameOfListFromTable instead.

See also: GetHolDateFromTable, GetHolIdFromTable, GetHolTextFromTable, GetHolNameOfListFromTable, the ALWAYS holiday name variation.

Topic 105137, last updated on 13-Sep-2026