cmelda/holidays

Holidays and Name's day by country

v1.5 2026-04-14 14:36 UTC

Requires

• php: >=8.3
• ext-json: *

Requires (Dev)

• arxeiss/coding-standards: ^0.14
• codeception/codeception: ^5.1
• codeception/module-asserts: ^3
• phpstan/phpstan: ^2.0
• rector/rector: ^2.0

Suggests

• ext-calendar: *

MIT

• Jiri Smach

• time
• date
• calendar
• holiday
• holidays
• celebration
• dateime

README

Install

composer require cmelda/holidays

List of available countries

List

Usage

Public Holiday

$holidays = new \Cmelda\Holidays\Holidays('cze');

$date = new DateTimeImmutable();

$day = $holidays->getDay($date);

try {
    $publicHolidays = $day->getPublicHoliday();
} catch (\Cmelda\Holidays\Exceptions\NoPublicHolidayException $e) {
    // no public holiday
}

Name's day

$holidays = new \Cmelda\Holidays\Holidays('cze');

$date = new DateTimeImmutable();

$day = $holidays->getDay($date);

try {
    $names = $day->getNames();
} catch (\Cmelda\Holidays\Exceptions\NoNameException $e) {
    // no name's day
}

Day

$date = new DateTimeImmutable();

$day = new \Cmelda\Holidays\Day($date);

try {
    $names = $day->getNames('cze');
} catch (\Cmelda\Holidays\Exceptions\NoNameException $e) {
    // no name's day
}

try {
    $names = $day->getNames('svk');
} catch (\Cmelda\Holidays\Exceptions\NoNameException $e) {
    // no name's day
}

Business day calculation

use Cmelda\Holidays\BusinessDayCalculator;

$calculator = new BusinessDayCalculator('cze');

$calculator->isWeekend(new DateTimeImmutable('2024-12-21')); // true
$calculator->isHoliday(new DateTimeImmutable('2024-12-24')); // true
$calculator->isWorkingDay(new DateTimeImmutable('2024-12-27')); // true

$nextWorkingDay = $calculator->nextWorkingDay(new DateTimeImmutable('2024-12-24'));
echo $nextWorkingDay->format('Y-m-d'); // 2024-12-27

$afterOneWorkingDay = $calculator->addWorkingDays(
    new DateTimeImmutable('2024-03-28'),
    1,
);
echo $afterOneWorkingDay->format('Y-m-d'); // 2024-04-02

$includingStartDay = $calculator->addWorkingDays(
    new DateTimeImmutable('2024-03-27'),
    1,
    true,
);
echo $includingStartDay->format('Y-m-d'); // 2024-03-27

If you need all calculations to use a specific timezone, pass it to the constructor:

use Cmelda\Holidays\BusinessDayCalculator;

$calculator = new BusinessDayCalculator(
    'cze',
    new DateTimeZone('Europe/Prague'),
);

License

Distributed under the MIT License. See LICENSE.txt for more information.

Donation