PHPackages                             p-potsikas/laravel-hellenic-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. p-potsikas/laravel-hellenic-holidays

ActiveLibrary[Utility & Helpers](/categories/utility)

p-potsikas/laravel-hellenic-holidays
====================================

Laravel package for Greek public holidays, observances and fixed namedays.

v1.0.0(1mo ago)02MITPHPPHP ^8.2|^8.3|^8.4CI failing

Since Jun 20Pushed 1mo agoCompare

[ Source](https://github.com/p-potsikas/laravel-hellenic-holidays)[ Packagist](https://packagist.org/packages/p-potsikas/laravel-hellenic-holidays)[ RSS](/packages/p-potsikas-laravel-hellenic-holidays/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Laravel Hellenic Holidays
=========================

[](#laravel-hellenic-holidays)

```
██╗  ██╗███████╗██╗     ██╗     ███████╗███╗   ██╗██╗ ██████╗
██║  ██║██╔════╝██║     ██║     ██╔════╝████╗  ██║██║██╔════╝
███████║█████╗  ██║     ██║     █████╗  ██╔██╗ ██║██║██║
██╔══██║██╔══╝  ██║     ██║     ██╔══╝  ██║╚██╗██║██║██║
██║  ██║███████╗███████╗███████╗███████╗██║ ╚████║██║╚██████╗
╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═╝ ╚═════╝

██╗  ██╗ ██████╗ ██╗     ██╗██████╗  █████╗ ██╗   ██╗███████╗
██║  ██║██╔═══██╗██║     ██║██╔══██╗██╔══██╗╚██╗ ██╔╝██╔════╝
███████║██║   ██║██║     ██║██║  ██║███████║ ╚████╔╝ ███████╗
██╔══██║██║   ██║██║     ██║██║  ██║██╔══██║  ╚██╔╝  ╚════██║
██║  ██║╚██████╔╝███████╗██║██████╔╝██║  ██║   ██║   ███████║
╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚══════╝

```

> Wake up, Laravel... The Greek holidays have been calculated. Follow the Orthodox Easter offset.

Laravel package for Greek public holidays and observances, implemented in pure PHP.

The package supports Laravel 10, 11 and 12, and provides a service, facade and helper for common holiday, working-day and nameday checks.

Installation
------------

[](#installation)

Install from Packagist:

```
composer require p-potsikas/laravel-hellenic-holidays
```

If the package has not been published to Packagist yet, install directly from GitHub:

```
composer config repositories.laravel-hellenic-holidays vcs https://github.com/p-potsikas/laravel-hellenic-holidays
composer require p-potsikas/laravel-hellenic-holidays:dev-main
```

Publish the configuration file:

```
php artisan vendor:publish --tag=hellenic-holidays-config
```

Laravel auto-discovery registers the service provider automatically.

Usage
-----

[](#usage)

```
use HellenicHolidays;

$holidays = HellenicHolidays::getHolidays(2026);
$result = HellenicHolidays::isHoliday('2026-12-25');
$next = HellenicHolidays::getNextHoliday();
$isWorkingDay = HellenicHolidays::isWorkingDay('2026-06-19');
$namedays = HellenicHolidays::getNamedaysForDate('2026-01-17');
$isNameday = HellenicHolidays::isNameday('Αντώνης', '2026-01-17');
```

You can also import the facade class directly:

```
use Potsikas\LaravelHellenicHolidays\Facades\HellenicHolidays;
```

Helper:

```
$holidays = hellenic_holidays()->getHolidays(2026);
```

The facade exposes:

```
HellenicHolidays::getHolidays(2026);
HellenicHolidays::isHoliday('2026-12-25');
HellenicHolidays::getNextHoliday('2026-12-24');
HellenicHolidays::getHolidaysByType(2026, 'national');
HellenicHolidays::isWorkingDay('2026-06-19');
HellenicHolidays::orthodoxEaster(2026);
HellenicHolidays::getNamedays(2026);
HellenicHolidays::getNamedaysForDate('2026-01-17');
HellenicHolidays::getNamedaysForName('Αντώνης', 2026);
HellenicHolidays::isNameday('Αντώνης', '2026-01-17');
```

Controller Example
------------------

[](#controller-example)

```