NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #2040 most downloaded on Packagist
Calculate public holidays
Last release 1 months ago
08 Sep 2026
Release timing varies
gaps range from 9 days to 5 months
Nearly every release is documented
notes for 47 of 48 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
48 releases · first in 2024
Fix Turkey Eid al-Adha 1971 date by @freekmurze in #341
Full Changelog: 2.5.0...2.5.1
Full Changelog: https://github.com/spatie/holidays/compare/2.5.0...2.5.1
Update pestphp/pest requirement from ^4.0 to ^5.0 by @dependabot [bot] in #338
Full Changelog: 2.4.0...2.5.0
One column per month.
Full Changelog: https://github.com/spatie/holidays/compare/2.4.0...2.5.0
Bump actions/checkout from 6 to 7 by @dependabot [bot] in #333
Full Changelog: 2.3.0...2.4.0
Full Changelog: https://github.com/spatie/holidays/compare/2.3.0...2.4.0
Add new Colombian national holiday from year 2026 by @luisprmat in #332
Full Changelog: 2.2.0...2.3.0
Full Changelog: https://github.com/spatie/holidays/compare/2.2.0...2.3.0
Adds Brazilian regions by @leobeal in #331
Full Changelog: https://github.com/spatie/holidays/compare/2.1.0...2.2.0
Bump dependabot/fetch-metadata from 3.0.0 to 3.1.0 by @dependabot [bot] in #329
Full Changelog: 2.0.3...2.1.0
Full Changelog: https://github.com/spatie/holidays/compare/2.0.3...2.1.0
fix: add Easter Sunday and use official Epiphany name for Croatia by @vblazenka in #328
Full Changelog: 2.0.2...2.0.3
Full Changelog: https://github.com/spatie/holidays/compare/2.0.2...2.0.3
Fix: Add Carnival Tuesday as public holiday for Venezuela by @MathewsJose in #313
Full Changelog: 2.0.1...2.0.2
Full Changelog: https://github.com/spatie/holidays/compare/2.0.1...2.0.2
Add Saint Francis holiday to Italy by @Lukasss93 in #327
Full Changelog: 2.0.0...2.0.1
Full Changelog: https://github.com/spatie/holidays/compare/2.0.0...2.0.1
Upgrade guide: https://github.com/spatie/holidays/blob/main/UPGRADING.md#from-v1-to-v2
Upgrade guide: https://github.com/spatie/holidays/blob/main/UPGRADING.md#from-v1-to-v2
Full Changelog: 1.24.0...2.0.0
Upgrade guide: https://github.com/spatie/holidays/blob/main/UPGRADING.md#from-v1-to-v2
Full Changelog: https://github.com/spatie/holidays/compare/1.24.0...2.0.0
Bump actions/checkout from 5 to 6 by @dependabot [bot] in #299
Full Changelog: 1.23.0...1.24.0
Full Changelog: https://github.com/spatie/holidays/compare/1.23.0...1.24.0
update holidays in Ghana by @petersowah in https://github.com/spatie/holidays/pull/285
Full Changelog: https://github.com/spatie/holidays/compare/1.22.1...1.23.0
refactor(isHoliday): simplify date comparison logic and improve efficiency by @Ayoub-Mabrouk in https://github.com/spatie/holidays/pull/268
Full Changelog: https://github.com/spatie/holidays/compare/1.22.0...1.22.1
Added Symfony 8 support to all symfony/* packages. by @thecaliskan in https://github.com/spatie/holidays/pull/298
Full Changelog: https://github.com/spatie/holidays/compare/1.21.0...1.22.0
ci: add tests for PHP 8.5 by @Chris53897 in https://github.com/spatie/holidays/pull/292
Full Changelog: https://github.com/spatie/holidays/compare/1.20.0...1.21.0
add Tag der Befreiung in 2025 for Berlin by @hebbet in https://github.com/spatie/holidays/pull/291
Full Changelog: https://github.com/spatie/holidays/compare/1.19.0...1.20.0
Bump stefanzweifel/git-auto-commit-action from 6 to 7 by @dependabot[bot] in https://github.com/spatie/holidays/pull/290
Full Changelog: https://github.com/spatie/holidays/compare/1.18.0...1.19.0
Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot[bot] in https://github.com/spatie/holidays/pull/274
Slovakia country by @patressz in https://github.com/spatie/holidays/pull/284Georgia by @lukakilai in https://github.com/spatie/holidays/pull/288Full Changelog: https://github.com/spatie/holidays/compare/1.17.3...1.18.0
feat: add Christmas Eve from year 2025 for Poland by @Kenny1291 in https://github.com/spatie/holidays/pull/271
Full Changelog: https://github.com/spatie/holidays/compare/1.17.2...1.17.3
refactor: simplify null coalescing and optional chaining in getOverlapping by @Ayoub-Mabrouk in https://github.com/spatie/holidays/pull/265
Full Changelog: https://github.com/spatie/holidays/compare/1.17.1...1.17.2
Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in https://github.com/spatie/holidays/pull/259
Full Changelog: https://github.com/spatie/holidays/compare/1.17.0...1.17.1
Fix: some of the dates for Argentina where incorrectly formated by @Akrista in https://github.com/spatie/holidays/pull/255
Full Changelog: https://github.com/spatie/holidays/compare/1.16.0...1.17.0
Add new country Paraguay by @hschimpf in https://github.com/spatie/holidays/pull/254
Paraguay by @hschimpf in https://github.com/spatie/holidays/pull/254Full Changelog: https://github.com/spatie/holidays/compare/1.15.0...1.16.0
feat: add calendar for Nepal by @maskeynihal in https://github.com/spatie/holidays/pull/247
Full Changelog: https://github.com/spatie/holidays/compare/1.14.1...1.15.0
Update laravel/prompts requirement from ^0.2.0 to ^0.3.0 by @dependabot in https://github.com/spatie/holidays/pull/244
Full Changelog: https://github.com/spatie/holidays/compare/1.14.0...1.14.1
Update laravel/prompts requirement from ^0.1.15 to ^0.2.0 by @dependabot in https://github.com/spatie/holidays/pull/238
Full Changelog: https://github.com/spatie/holidays/compare/1.13.1...1.14.0
Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in https://github.com/spatie/holidays/pull/233
Full Changelog: https://github.com/spatie/holidays/compare/1.13.0...1.13.1
Add getInRange function by @inDeev in https://github.com/spatie/holidays/pull/150
Full Changelog: https://github.com/spatie/holidays/compare/1.12.0...1.13.0
Add Maldivian holidays by @ahmedmansoor in https://github.com/spatie/holidays/pull/229
Full Changelog: https://github.com/spatie/holidays/compare/1.11.0...1.12.0
Add holidays for korea by @jws1837 in https://github.com/spatie/holidays/pull/222
Full Changelog: https://github.com/spatie/holidays/compare/1.10.0...1.11.0
add Tunisia Holidays by @mr-wolf-gb in https://github.com/spatie/holidays/pull/109
Slovakia country by @patressz in https://github.com/spatie/holidays/pull/223Full Changelog: https://github.com/spatie/holidays/compare/1.9.1...1.10.0
Bump dependabot/fetch-metadata from 1.6.0 to 2.0.0 by @dependabot in https://github.com/spatie/holidays/pull/215
Full Changelog: https://github.com/spatie/holidays/compare/1.9.0...1.9.1
Implement Islamic calendar by @Nielsvanpach in https://github.com/spatie/holidays/pull/214
Full Changelog: https://github.com/spatie/holidays/compare/1.8.0...1.9.0
Adding holidays for Bahrain by @bo3bdo in https://github.com/spatie/holidays/pull/206
Full Changelog: https://github.com/spatie/holidays/compare/1.7.0...1.8.0
Add Uzbekistan Holidays by @shoxrux1996 in https://github.com/spatie/holidays/pull/81
Full Changelog: https://github.com/spatie/holidays/compare/1.6.1...1.7.0
Fixes for Egyptian holidays by @wessama in https://github.com/spatie/holidays/pull/155
Full Changelog: https://github.com/spatie/holidays/compare/1.6.0...1.6.1
Add holidays for Argentine by @damian-developer in https://github.com/spatie/holidays/pull/200
Full Changelog: https://github.com/spatie/holidays/compare/1.5.1...1.6.0
Fix translations for Albania & Iran
Fix translations for Albania & Iran
Full Changelog: https://github.com/spatie/holidays/compare/1.5.0...1.5.1
Fix Danish Easter dates offset by @danielboendergaard in https://github.com/spatie/holidays/pull/197
Egypt Holidays by @michaelnabil230 in https://github.com/spatie/holidays/pull/35Full Changelog: https://github.com/spatie/holidays/compare/1.4.0...1.5.0
Add Montenegro holidays by @Rkishahaha in https://github.com/spatie/holidays/pull/171
Full Changelog: https://github.com/spatie/holidays/compare/1.3.0...1.4.0
Add Ukrainian holidays by @kapi14 in https://github.com/spatie/holidays/pull/112
Full Changelog: https://github.com/spatie/holidays/compare/1.2.0...1.3.0
Added Dominican Republic holidays by @KiritoXD01 in https://github.com/spatie/holidays/pull/57
Full Changelog: https://github.com/spatie/holidays/compare/1.1.0...1.2.0
Fix incorrect usage in README by @cybernerdie in https://github.com/spatie/holidays/pull/16
Full Changelog: https://github.com/spatie/holidays/compare/1.0.2...1.1.0
Add holidays for Austria @felixfrey in https://github.com/spatie/holidays/pull/6
Full Changelog: https://github.com/spatie/holidays/compare/1.0.1...1.0.2
Full Changelog: https://github.com/spatie/holidays/compare/1.0.0...1.0.1
Full Changelog: https://github.com/spatie/holidays/compare/1.0.0...1.0.1
Full Changelog: https://github.com/spatie/holidays/compare/0.0.2...1.0.0
Full Changelog: https://github.com/spatie/holidays/compare/0.0.2...1.0.0
Add Hungary to the supported countries by @xHeaven in https://github.com/spatie/holidays/pull/3
Full Changelog: https://github.com/spatie/holidays/compare/0.0.1...0.0.2
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →