Usage

Check if any holiday

use Carbon\Carbon;

$date = Carbon::parse('2021-12-25');
$date->isHoliday(); // true

$date = Carbon::parse('2021-06-15');
$date->isHoliday(); // false

Check specific holidays

You can check for individual holidays using either English or Dutch method names:

// English method names
$date = Carbon::parse('2021-12-25');
$date->isChristmasDay(); // true

$date = Carbon::parse('2021-04-27');
$date->isKingsDay(); // true

$date = Carbon::parse('2021-01-01');
$date->isNewYear(); // true

// Dutch method names
$date = Carbon::parse('2021-12-25');
$date->isEersteKerstdag(); // true

$date = Carbon::parse('2021-04-27');
$date->isKoningsdag(); // true

$date = Carbon::parse('2021-01-01');
$date->isNieuwjaarsdag(); // true

Available Methods

All methods work with both Carbon and CarbonImmutable instances.

Holiday (English)	Holiday (Dutch)	English Method	Dutch Method	Date
New Year's Day	Nieuwjaarsdag	`isNewYear()`	`isNieuwjaarsdag()`	January 1
Good Friday	Goede Vrijdag	`isGoodFriday()`	`isGoedeVrijdag()`	Friday before Easter
Easter Sunday	Paaszondag	`isEasterSunday()`	`isPaaszondag()`	Calculated
Easter Monday	Paasmaandag	`isEasterMonday()`	`isPaasmaandag()`	Monday after Easter
King's Day	Koningsdag	`isKingsDay()`	`isKoningsdag()`	April 27*
Liberation Day	Bevrijdingsdag	`isLiberationDay()`	`isBevrijdingsdag()`	May 5
Ascension Day	Hemelvaart	`isAscensionDay()`	`isHemelvaart()`†	Thursday, Easter + 39 days
Pentecost	Pinksterzondag	`isPentecost()`‡	`isPinksterzondag()`	Sunday, Easter + 49 days
Pentecost Monday	Pinkstermaandag	`isPentecostMonday()`‡	`isPinkstermaandag()`	Monday, Easter + 50 days
Christmas Day	Eerste Kerstdag	`isChristmasDay()`	`isEersteKerstdag()`	December 25
Boxing Day	Tweede Kerstdag	`isBoxingDay()`	`isTweedeKerstdag()`	December 26

* King's Day is April 26 when April 27 falls on a Sunday † Also available as isHemelvaartsdag() ‡ Aliases available: isWhitsunday() and isWhitMonday()

Practical Examples

King's Day / Koningsdag

// Normal King's Day (April 27)
Carbon::parse('2021-04-27')->isKingsDay(); // true

// When April 27 is Sunday, celebrated on April 26
Carbon::parse('2025-04-26')->isKoningsdag(); // true
Carbon::parse('2025-04-27')->isKoningsdag(); // false

// Easter Sunday 2021
Carbon::parse('2021-04-04')->isEasterSunday(); // true
Carbon::parse('2021-04-04')->isPaaszondag(); // true

// Good Friday (the Friday before Easter)
Carbon::parse('2021-04-02')->isGoodFriday(); // true
Carbon::parse('2021-04-02')->isGoedeVrijdag(); // true

// Ascension Day (Thursday, 39 days after Easter)
Carbon::parse('2021-05-13')->isAscensionDay(); // true
Carbon::parse('2021-05-13')->isHemelvaart(); // true

// Pentecost (Sunday, 49 days after Easter)
Carbon::parse('2021-05-23')->isPentecost(); // true
Carbon::parse('2021-05-23')->isWhitsunday(); // true (alias)
Carbon::parse('2021-05-23')->isPinksterzondag(); // true (Dutch)

Working with CarbonImmutable

use Carbon\CarbonImmutable;

$date = CarbonImmutable::parse('2021-12-25');
$date->isChristmasDay(); // true
$date->isEersteKerstdag(); // true

Check if any holiday#

Check specific holidays#

Available Methods#

Practical Examples#

King's Day / Koningsdag#

Easter-related holidays#

Working with CarbonImmutable#