NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #993 most downloaded on Packagist
The easy PHP Library for calculating holidays
Last release 8 days ago
30 Sep 2026
Ships fairly regularly
a new release about every 8 months
Some releases are documented
notes for 11 of 24 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
24 releases · first in 2015
Yasumi 2.12 is here! In this new release of Yasumi we welcome Colombia and Kenya to the list of providers, increasing the list of countries to 49. Nex
Yasumi 2.12 is here! In this new release of Yasumi we welcome Colombia and Kenya to the list of providers, increasing the list of countries to 49. Next to new providers, numerous fixes and improvements have made it into this release since the last one, so it is definitely worthwhile to upgrade.
In a recent discussion, it became evident that it wasn't really clear when a new release of Yasumi was to be expected. Up until not too long ago, I made a release whenever a useful set of changes had accumulated, which over time made the release history look somewhat arbitrary.
To make it easier for users to understand when a next release is to be expected, a Release Policy has now been added to the project. At a minimum, two releases per year will be made: one in March (Spring Release) and one in September (Autumn Release). I hope it makes the release cadence a little more predictable.
Full Changelog: 2.11.0...2.12.0
One column per quarter.
As the cherry blossoms begin to bloom and the season shifts toward renewal in many parts of the world, we are excited to announce a new release of Yas
As the cherry blossoms begin to bloom and the season shifts toward renewal in many parts of the world, we are excited to announce a new release of Yasumi. This update focuses on expanding again the list of providers while improving the internal architecture and testing standards of the library.
The family of holiday providers continues to grow with the addition of Venezuela, San Marino, and Andorra. We have also introduced "Czechia" as a more concise provider alias to better align with current conventions.
getHoliday and a few other updates to improve the overall performance and memory usageFull Changelog: 2.10.0...2.11.0
Yasumi v2.10.0 is only a minor (maintenance) release which covers the end of support of PHP 8.1 and some internal documentation updates.
Yasumi v2.10.0 is only a minor (maintenance) release which covers the end of support of PHP 8.1 and some internal documentation updates.
Updating to the latest version is always recommended, however if you are still on PHP 8.1, running Yasumi v2.9.0 is perfectly fine.
Full Changelog: 2.9.0...2.10.0
Christmas may be over, but we still have a small present to wrap up the year: Yasumi 2.9.0. This release brings a variety of holiday provider improvem
Christmas may be over, but we still have a small present to wrap up the year: Yasumi 2.9.0. This release brings a variety of holiday provider improvements, enhancements, and bug fixes. And of course: support for PHP 8.5.
Highlights of version 2.9.0:
After a very long time finally a new Yasumi release! Yasumi 2.8.0 includes numerous of holiday provider improvements, enhancements and bug fixes. As o
After a very long time finally a new Yasumi release! Yasumi 2.8.0 includes numerous of holiday provider improvements, enhancements and bug fixes. As of this version, we will be using git-cliff and conventional commits. This helps to maintain a readable, standardized commit history, and enables automated versioning and changelog generation.
As such the CHANGELOG.md file will now only include changes made since version 2.8.0 and the prior list of changes are 'archived' in the CHANGELOG-ARCHIVE.md file.
Highlights of version 2.8.0
A new release for the new year! In addition to numerous improvements, bug fixes and code enhancements, this release also includes a new country: Mexic
A new release for the new year! In addition to numerous improvements, bug fixes and code enhancements, this release also includes a new country: Mexico. Also support for PHP 7.4 (and older) is dropped and support for PHP 8.3 is added.
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file.
twoDaysLaterNewYearsDay of South Korea has been removed from 1990, however the unit test for the nameThere is a fresh release at last! I really believe in releasing software as frequently as possible, yet I somehow neglected to do so for more than a y
There is a fresh release at last! I really believe in releasing software as frequently as possible, yet I somehow neglected to do so for more than a year. Even though a lot of work was completed during that time, I was just unable to pick the ideal moment to make an official release.
Despite the fact that no new countries are included in this release, there are several upgrades, corrections, and refinements that make Yasumi 2.6 worthwhile to upgrade to.
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file of this project or navigate to the v2.6 release blog post.
other and changed to an official holiday intz db, a correction for 1947 was made for the summertime transition in Denmark to AprilFull Changelog: 2.5.0...2.6.0
It is that time again; the time for a new release!
It is that time again; the time for a new release!
We have two more countries, and for a few countries new holidays are added, or regulations have been revised. Even more importantly, support for PHP 7.3 has been dropped, so all the more reason to upgrade to version 2.5.
The documentation site has undergone a few changes, specifically to support readers with disabilities. And lastly, head over to GitHub Discussions to ask questions or share your ideas.
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file of this project or navigate to the v2.5 release blog post.
calculateSubstituteHolidays method of South Korea Provider to calculateSubstituteHolidayscalculateOldSubstituteHolidays #255 (barami)Other for states celebrating this day. This was incorrect (or officially changed) and has been altered to Official #263.Other for states celebrating this day. This was incorrect (or officially changed) and has been altered to Official #252.The substitute holiday unit test as the use of the at() method will be deprecated in PHPUnit 10.
Yasumi v2.4 is a minor (maintenance) release which includes Georgia as a new Holiday Provider and several stability and bug fixes for issues discovered since v2.3.
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file of this project or navigate to the v2.4 release blog post.
WEEKEND_DATA constant in provider classes to be overridden. #235 (Mahmood Dhia).gitattributes file to reduce the size of a release package #237 (Stéphane)at() method will be deprecated in PHPUnit 10.Fribourg::calculateBerchtoldsTag() and Fribourg::calculateDecember26th (Switzerland)You have probably seen the new documentation website already, and following I am pleased to announce a new release of Yasumi is available as of today
You have probably seen the new documentation website already, and following I am pleased to announce a new release of Yasumi is available as of today for download or using your Composer configuration. Yasumi v2.3 is a minor release which brings two new providers to the pool (Canada and Luxembourg) and several important stability and bug fixes for issues discovered since v2.2.
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file of this project or navigate to the v2.3 release blog post.
With the summer having come to an end, you may feel reinvigorated to give your PHP project(s) a clean up. And why not upgrade Yasumi to the next versi
With the summer having come to an end, you may feel reinvigorated to give your PHP project(s) a clean up. And why not upgrade Yasumi to the next version while you are at it? Because from today v2.2 is officially available!
Below you will find a summary of the most significant changes. For more details, please check the CHANGELOG file of this project or navigate to the v2.2 release blog post.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →