V2: Extend API functionalities

[Nielsvanpach]

Changes

Holidays::for('be')->isTodayHoliday(); // true or false

$holidays = Holidays::for('be')->getUpcoming(3);

// Returns the next 3 upcoming holidays
foreach ($holidays as $holiday) {
    echo $holiday->date; // CarbonImmutable
    echo $holiday->name;
}

$longWeekends = Holidays::for('de', 2024)->getLongWeekends();

// With custom minimum days (default: 4)
$longWeekends = Holidays::for('de', 2024)->getLongWeekends(3);

foreach ($longWeekends as $weekend) {
    echo $weekend->startDate; // First day of the long weekend
    echo $weekend->endDate;   // Last day of the long weekend
    echo $weekend->dayCount;  // Number of days
    echo $weekend->holidays;  // Array of Holiday objects
}