PHPackages codebros-nl/dutch-holidays - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. codebros-nl/dutch-holidays ActiveLibrary[Utility & Helpers](/categories/utility) codebros-nl/dutch-holidays ========================== Nederlandse feestdagen en werkdagberekeningen voor Laravel, met cao-/sector-profielen. 1.0.0(2w ago)0109↑1441.3%MITPHPPHP ^8.2 Since May 22Pushed 2w agoCompare [ Source](https://github.com/CodeBros-Software/dutch-holidays)[ Packagist](https://packagist.org/packages/codebros-nl/dutch-holidays)[ RSS](/packages/codebros-nl-dutch-holidays/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (6)Versions (2)Used By (0) Nederlandse feestdagen voor Laravel =================================== [](#nederlandse-feestdagen-voor-laravel) Nederlandse feestdagen en werkdagberekeningen voor Laravel, met **sector- en cao-profielen** zodat je per klant of branche kunt configureren welke dagen vrij zijn. Geen externe dependencies voor de holiday-berekeningen — alles is intern via het Gauss-algoritme. --- Features -------- [](#features) - ✅ Alle nationale Nederlandse feestdagen met automatische berekening (Pasen, Hemelvaart, Pinksteren, Koningsdag-uitzondering) - ✅ **10 voorgedefinieerde sectorprofielen** (overheid, bouw, zorg, onderwijs, ICT, grafimedia, ...) - ✅ **Eigen sectoren/cao's** registreren met custom policies - ✅ Per-feestdag policy: `Official`, `Always`, `Never` - ✅ Extra niet-wettelijke dagen (carnaval, Sinterklaas, Oudejaarsdag, ...) - ✅ Werkdag-helpers: `isWorkday()`, `nextWorkday()`, `addWorkdays()`, `workdaysBetween()` - ✅ Carbon-macro's: `Carbon::today()->isDutchHoliday()` - ✅ Artisan-commands voor inspectie - ✅ Immutable, multi-tenant safe - ✅ Volledig PHP 8.2+ met `readonly`, enums, named args --- Installatie ----------- [](#installatie) ``` composer require codebros-nl/dutch-holidays ``` Publiceer optioneel de config: ``` php artisan vendor:publish --tag=dutch-holidays-config ``` --- Snelstart --------- [](#snelstart) ``` use CodeBros\DutchHolidays\Facades\DutchHolidays; // Alle feestdagen voor 2026 DutchHolidays::forYear(2026); // Alleen wettelijke vrije dagen DutchHolidays::officialHolidays(2026); // Check een datum DutchHolidays::isHoliday('2026-12-25'); // true DutchHolidays::isWorkday('2026-05-05'); // true (default sector, geen lustrumjaar) // Werkdag-rekenen DutchHolidays::nextWorkday('2026-12-24'); // 2026-12-28 DutchHolidays::workdaysBetween('2026-01-01', '2026-12-31'); // ~252 DutchHolidays::addWorkdays('2026-12-24', 5); // datum + 5 werkdagen ``` --- Sectoren (cao's) ---------------- [](#sectoren-caos) Het grootste verschil tussen cao's is welke dagen wel of niet vrij zijn. Daarom werkt het pakket met **sectorprofielen**. ### Beschikbare sectoren [](#beschikbare-sectoren) KeySectorGoede VrijdagBevrijdingsdag`default`Wettelijkneelustrumjaren`government`Overheidjaja`construction`Bouwjaja`metal`Metaal & Techniekjalustrumjaren`healthcare`Zorgjalustrumjaren`education`Onderwijsjaja`hospitality`Horecaneelustrumjaren`ict`ICT / Softwareneeja`grafimedia`Grafimediajaja`retail`Retailneelustrumjaren### Sector kiezen [](#sector-kiezen) ``` use CodeBros\DutchHolidays\Enums\Sector; // Via enum (aanbevolen) DutchHolidays::sector(Sector::Construction)->daysOff(2026); // Of als string DutchHolidays::sector('government')->isWorkday('2026-04-03'); // Goede Vrijdag → false ``` ### Default sector instellen [](#default-sector-instellen) In `.env`: ``` DUTCH_HOLIDAYS_SECTOR=construction ``` Of in `config/dutch-holidays.php`: ``` 'default_sector' => Sector::Construction->value, ``` --- Eigen sectoren / cao's ---------------------- [](#eigen-sectoren--caos) ### Methode 1: ad-hoc policies [](#methode-1-ad-hoc-policies) Voor incidenteel gebruik zonder een sector aan te maken: ``` use CodeBros\DutchHolidays\Enums\HolidayKey; use CodeBros\DutchHolidays\Enums\HolidayPolicy; DutchHolidays::withPolicies([ HolidayKey::GoodFriday->value => HolidayPolicy::Always, HolidayKey::LiberationDay->value => HolidayPolicy::Never, ])->forYear(2026); ``` ### Methode 2: SectorProfile registreren [](#methode-2-sectorprofile-registreren) Voor cao's die je vaker nodig hebt — registreer ze in een `ServiceProvider`: ``` use CodeBros\DutchHolidays\Facades\DutchHolidays; use CodeBros\DutchHolidays\SectorProfile; use CodeBros\DutchHolidays\Enums\HolidayKey; use CodeBros\DutchHolidays\Enums\HolidayPolicy; public function boot(): void { DutchHolidays::registerSector('werkpunt_klant_a', new SectorProfile( name: 'Klant A — eigen cao', policies: [ HolidayKey::GoodFriday->value => HolidayPolicy::Always, HolidayKey::LiberationDay->value => HolidayPolicy::Always, ], extraHolidays: [HolidayKey::NewYearsEve], description: 'Klant heeft 5 mei en Oudejaarsdag als extra vrije dag.', )); } ``` Daarna: ``` DutchHolidays::sector('werkpunt_klant_a')->daysOff(2026); ``` ### Methode 3: dynamisch per klant in een service [](#methode-3-dynamisch-per-klant-in-een-service) Bij multi-tenant apps waar policies in de database staan: ``` class HolidayService { public function __construct(private DutchHolidays $holidays) {} public function daysOffFor(Klant $klant, int $year): HolidayCollection { $policies = []; if ($klant->goede_vrijdag_vrij) { $policies[HolidayKey::GoodFriday->value] = HolidayPolicy::Always; } if ($klant->bevrijdingsdag_vrij) { $policies[HolidayKey::LiberationDay->value] = HolidayPolicy::Always; } return $this->holidays ->sector($klant->basis_sector ?? 'default') ->withPolicies($policies) ->daysOff($year); } } ``` --- Extra (niet-wettelijke) dagen ----------------------------- [](#extra-niet-wettelijke-dagen) Voor regionale of bedrijfsspecifieke dagen: ``` DutchHolidays::withExtraHolidays( HolidayKey::CarnivalMonday, HolidayKey::CarnivalTuesday, )->forYear(2026); ``` Beschikbare extra-keys: - `HolidayKey::CarnivalMonday` / `CarnivalTuesday` - `HolidayKey::Sinterklaas` - `HolidayKey::ChristmasEve` - `HolidayKey::NewYearsEve` --- Werkdag-helpers --------------- [](#werkdag-helpers) ``` // Is dit een werkdag in de huidige sector? DutchHolidays::isWorkday('2026-05-05'); // Volgende / vorige werkdag DutchHolidays::nextWorkday(now()); DutchHolidays::previousWorkday('2026-12-27'); // Werkdagen tellen tussen twee datums (inclusief) DutchHolidays::workdaysBetween('2026-01-01', '2026-12-31'); // N werkdagen optellen (slaat weekenden + feestdagen over) DutchHolidays::addWorkdays('2026-12-24', 5); DutchHolidays::addWorkdays('2026-12-28', -2); ``` --- Carbon-macro's -------------- [](#carbon-macros) Zijn standaard geregistreerd (uit te zetten via config): ``` Carbon::today()->isDutchHoliday(); // bool Carbon::today()->isDutchWorkday(); // bool Carbon::today()->nextDutchWorkday(); // CarbonImmutable Carbon::today()->previousDutchWorkday(); // CarbonImmutable Carbon::today()->addDutchWorkdays(5); // CarbonImmutable Carbon::today()->dutchHoliday(); // ?Holiday ``` --- Datumbereik en meerdere jaren ----------------------------- [](#datumbereik-en-meerdere-jaren) ``` // Tussen twee datums (jaargrenzen overspannen mag) DutchHolidays::between('2025-12-01', '2026-03-31'); // Alleen wettelijke DutchHolidays::between('2025-12-01', '2026-03-31', officialOnly: true); // Meerdere jaren tegelijk $multi = DutchHolidays::forYears(2025, 2026, 2027); $multi[2026]->official(); // HolidayCollection voor 2026 ``` --- Collections ----------- [](#collections) Resultaten zijn `HolidayCollection`-instances (extends `\Illuminate\Support\Collection`) met handige scoping: ``` $holidays = DutchHolidays::forYear(2026); $holidays->official(); // alleen vrije dagen $holidays->unofficial(); // alleen niet-vrije (Goede Vrijdag in default) $holidays->from('2026-06-01'); // vanaf datum $holidays->until('2026-06-30'); // tot en met datum $holidays->byKey(HolidayKey::Christmas); $holidays->asMap(); // ['2026-12-25' => 'Eerste Kerstdag', ...] $holidays->dates(); // alleen Carbon-datums ``` Plus alle standaard Collection-methods (`filter`, `map`, `groupBy`, ...). --- Artisan-commands ---------------- [](#artisan-commands) ``` # Toon feestdagen voor huidig jaar (default sector) php artisan holidays:list # Voor een specifiek jaar php artisan holidays:list 2026 # Voor een specifieke sector php artisan holidays:list 2026 --sector=construction # Inclusief niet-officiële dagen php artisan holidays:list 2026 --all # Output als JSON php artisan holidays:list 2026 --json # Toon alle beschikbare sectoren php artisan holidays:sectors ``` --- Custom HolidayProvider (geavanceerd) ------------------------------------ [](#custom-holidayprovider-geavanceerd) Voor compleet eigen feestdagenbronnen (bijv. uit een database, een externe API of voor schoolvakanties) implementeer je `HolidayProvider`: ``` use CodeBros\DutchHolidays\Contracts\HolidayProvider; use CodeBros\DutchHolidays\Holiday; use CodeBros\DutchHolidays\Enums\HolidayKey; use Carbon\CarbonImmutable; class CompanyClosureProvider implements HolidayProvider { public function holidaysFor(int $year): array { return [ new Holiday( key: HolidayKey::ChristmasEve, name: 'Bedrijfssluiting', date: CarbonImmutable::create($year, 12, 27), official: true, ), ]; } public function name(): string { return 'company-closure'; } } // Gebruik DutchHolidays::withProvider(new CompanyClosureProvider())->daysOff(2026); ``` Providers worden ná de nationale set toegevoegd en kunnen bestaande dagen overrulen via dezelfde `HolidayKey`. --- Disclaimer over cao-data ------------------------ [](#disclaimer-over-cao-data) De voorgedefinieerde sectorprofielen weerspiegelen de meest gangbare invulling, maar **cao-afspraken verschillen per werkgever en veranderen jaarlijks**. Controleer altijd de actuele cao van je klant en pas indien nodig aan via `->withPolicies()` of een eigen geregistreerde sector. --- Testing ------- [](#testing) ``` composer test composer test-coverage ``` --- License ------- [](#license) MIT — see [LICENSE.md](LICENSE.md). ### Health Score 42 — FairBetter than 88% of packages Maintenance96 Actively maintained with recent releases Popularity14 Limited adoption so far Community2 Small or concentrated contributor base Maturity46 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 18d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/951675?v=4)[Norman Reinhard](/maintainers/codebros-nl)[@codebros-nl](https://github.com/codebros-nl) --- Tags laravelholidaysnetherlandsworkdaysnederlandfeestdagencao ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/codebros-nl-dutch-holidays/health.svg) ``` [![Health](https://phpackages.com/badges/codebros-nl-dutch-holidays/health.svg)](https://phpackages.com/packages/codebros-nl-dutch-holidays) ``` ### Alternatives [spatie/laravel-responsecache Speed up a Laravel application by caching the entire response 2.8k8.7M64](/packages/spatie-laravel-responsecache)[laravel/ai The official AI SDK for Laravel. 9782.1M153](/packages/laravel-ai)[flarum/core Delightfully simple forum software. 261.4M2.2k](/packages/flarum-core)[zidbih/laravel-deadlock Make temporary Laravel workarounds expire and fail CI when ignored. 954.0k](/packages/zidbih-laravel-deadlock)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 19253.0k3](/packages/interaction-design-foundation-laravel-geoip)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.2k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)