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 and observances.

00PHPCI failing

Since Jun 20Pushed todayCompare

[ 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 today

READMEChangelogDependenciesVersions (1)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)

```