Non-Working Days

About Non-Working Days

icsdb is an open repository of ICS calendar files listing non-working days for multiple countries. It maintains auto-generated ICS files built from source data, translating event summaries into different languages and computing recurring dates such as Easter-based holidays for a range of years (1970 to 2100) using RDATE properties. Generated files are organized by country in a build subfolder, covering Belgium, France, Germany, Ireland, Switzerland, the United Kingdom, and the United States, with a differing number of files per country.

The project targets developers who need to integrate holiday or non-working-day data into applications via standard icalendar formats. Consuming the files requires a library capable of handling RRULE and RDATE properties, and the README lists compatible libraries for JavaScript (rrule, ical.js), Python (dateutil), Ruby (ri_cal), Java (ical4j), and PHP (SG-iCalendar). Events sharing the same date across calendars use a common UID property.

The repository also includes a build script (node src/build.js) for regenerating the ICS files from source data, requiring development dependencies. It links to a separate resource for French school holidays as an additional ICS source. The README notes that the file set may move to its own domain in the future, though the GitHub URL is expected to remain valid.

Key features

• Provides auto-generated ICS calendar files of non-working days for multiple countries
• Covers Belgium, France, Germany, Ireland, Switzerland, United Kingdom, and United States
• Translates event summaries into multiple languages
• Computes Easter-based holiday dates as RDATE properties from 1970 to 2100
• Uses consistent UID properties across calendars for matching dates

Frequently asked questions