nojimage/holiday-jp

This package will obtain information on Japanese public holidays based on the calendar information from the National Astronomical Observatory of Japan.

v1.2.1 2025-06-09 05:11 UTC

Requires

• php: ^8.2
• ext-json: *
• ext-mbstring: *
• cakephp/chronos: ^2.4|^3.0
• johngrogg/ics-parser: ^3.2.1

Requires (Dev)

• cakephp/collection: ^4.5|^5.0
• phpstan/phpstan: ^1.11
• phpunit/phpunit: ^10.5.5 || ^11.1.3 || ^12.0.9
• squizlabs/php_codesniffer: ^3.10

MIT

• nojimage

README

Overview

This package obtains information on Japanese public holidays based on the calendar information from the National Astronomical Observatory of Japan.

NOTE: Public holiday information before 2001 is not available.

Source: National Astronomical Observatory of Japan

Requirements

• PHP 8.2 or above

Installation

composer require nojimage/holiday-jp

Usage

use Nojimage\HolidayJp\HolidayJp;

$holidayJp = new HolidayJp();

// Get a list of holidays in 2024
$holidays = $holidayJp->getHolidays(2024);

// Get a list of holidays for the specified period
$holidays = $holidayJp->getHolidays(new DateTime('2024-01-01'), new DateTime('2024-12-31'));

// Check if a date is a holiday
$holidayJp->isHoliday('2024-01-01'); // true
$holidayJp->isHoliday('2024-01-02'); // false

Contributing

If you find any bugs or have suggestions for new features, please create an issue or submit a pull request.

License

This project is released under the MIT License.