Data sources

date-holidays

• Provider: date-holidays, version 3.35.0.
• Code licence: ISC. Data licence: CC-BY-3.0.
• Distribution: bundled with Calcadian.
• Project home: https://github.com/commenthol/date-holidays

Coverage

The dataset covers a large number of countries, and many of them at subdivision level, but it is not a complete record of every holiday everywhere. Coverage quality varies by country, and regional or local observances are the most likely to be missing.

• Where a subdivision is supported, choosing it changes which holidays apply.
• Where a subdivision is not supported, Calcadian refuses to save that combination rather than silently applying national rules.
• Observed and substitute days follow the source data, including cases where a holiday falling on a weekend moves to the next working day.
• Religious and lunar holidays whose dates are announced late may be approximate for future years.

Provider versions

Calcadian pins a specific version of the dataset, and that version is recorded in every Calculation Report. A later version can add, move or remove holidays, which means a calculation made today and the same calculation made after an update can legitimately differ. The report tells you which version produced which answer.

Known limitations

• Company and school closures are never in the dataset. Add those as custom holidays or excluded dates.
• Half-days and partial closures are not modelled. A day is either a working day or it is not.
• Governments announce and cancel holidays at short notice, and the dataset can lag those announcements.
• Sector-specific calendars, such as bank clearing or court schedules, are not included.