Please enable JavaScript to view this site.


Navigation: Holidays > Recurring Holidays

Importing Recurring Holidays from Excel

Scroll Prev Up Next More

To import recurring holidays from an MS-Excel file, use the Import from MS-Excel menu item of the recurring holidays toolbar menu in the holidays manager.


The goal of importing recurring holidays from an Excel file is to:


Import the holiday name, abbreviation and associated symbols.


Supply a simplistic recurrence rule for that imported holiday (this rule will need to be manually changed later, it cannot be imported from and Excel file).


Expected Column Layout


To import recurring holidays, make sure your Excel file contains the expected information in the expected columns:


Column A

Column A should contain the date.

The year can be any year, only the month and day matter.

Date Format 

Make sure you enter a date as 1/1/2024 or 3-5-2024, not as free text. If the date you supply is not understood, it will appear as Incorrect Date Format, as shown in the image on the right, in the Date column of the preview grid at the bottom of the import from Excel dialog.

Column B

Column B should contain the abbreviation(s) of the holiday.


Any underscore character "_" (without the quotes) contained in this string will be replaced by a non-breaking space and any tilde character "~" (without the quotes) contained in this string will be replaced by a normal space.

Column C

Column C should contain the symbol(s) of the holiday.

Column D

Column D contains the holiday name.


You can include special character markers, such as &t or &s or &c, to include tabulations or returns in the holiday names.


Using additional columns


Generally, the columns E-F-G-... to the right of column D are left empty, but there are cases when you might want to use these columns.


Importation Procedure


To import recurring holidays from an Excel file, prepared as described above:


1.Select the holidays set into which you want to import.

2.Use the holidays toolbar menu of the recurring holidays tab of the holidays manager, and select the Import from MS-Excel menu item.

3.At the top of the import from Excel dialog, select an Excel file (both the XLSX and the XLS file extensions are accepted).

the Excel file contents preview

the Excel file contents preview

4.Use the preview to specify at which row to start the importation (as shown in the example on the right, make sure you do not include title headers in the rows selected for import).

IMPORTANT: If the dates you see in the preview are 4 years earlier than what you are expecting to see, then this is due to the way the Excel file was saved on the Macintosh.

5.Decide if you want to import the contents of only one specific column, or of all non-blank columns (in which case you should specify the text to be used to separate each column's text, as shown in the examples of the previous section covering Column D).

6.Click on the import button. Once importation is complete, a dialog will come up informing you of the number of recurring holidays successfully imported.

Once the entire process is completed, that you must verify the proper rule for each holiday imported, either from a list given to you, or using the Holidays Rules Wizard, since a holiday appearing in the imported Excel file as "April 2, 2025", will be imported with the fixed date recurrence rule "every year on the day of April 2", although this rule may actually be based on Easter.


Topic 169900, last updated on 04-Nov-2023