Yasumi Laravel Package

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.

New Providers

• Add Venezuela holiday provider
• Add San Marino holiday provider
• Add Andorra holiday provider
• Add "Czechia" provider as a short form of "Czech Republic" (#397)

Updates

• (Spain) Fix murciaDay minimum year in RegionOfMurcia test
• (Spain) Fix Extremadura test
• (South Korea) Fix holiday type test of HangulDay
• (South Korea) Fix twoDaysLaterNewYearsDay test
• (United Kingdom) Fix year boundary and test conditions
• (Slovakia) Fix excluded years in data providers
• (NYSE) Fix tests for NYSE provider

Notable Improvements

• Removed unnecessary internal sorting on getHoliday and a few other updates to improve the overall performance and memory usage
• Increase PHPStan analysis level to 8
• Add AGENTS.md file
• (Test) Upgrade to PHPUnit 11
• (Test) Tighten default range for random year generator

New Contributors ❤️

• @ppaulis made their first contribution

Full Changelog: https://github.com/azuyalabs/yasumi/compare/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.

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: https://github.com/azuyalabs/yasumi/compare/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 improvements, enhancements, and bug fixes. And of course: support for PHP 8.5.

Highlights of version 2.9.0:

New Providers

• Slovenia - Complete holiday coverage for Slovenia
• NYSE - A custom holiday provider that can help you to track the holidays and closures for the New York Stock Exchange.

Updates

• Changes to a number of holidays in Slovakia
• Included (non-official) holidays for the Netherlands in the period between 2026 and 2028

Notable Improvements

• Added PHP 8.5 compatibility
• Improved performance and memory utilization
• Enhanced documentation and code quality
• Fixes for New Zealand

New Contributors ❤️

• @Stollie made their first contribution
• @mgwebgroup made their first contribution
• @soukicz made their first contribution
• @timeshifting made their first contribution

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

New Providers

• Bulgaria - Complete holiday coverage for Bulgaria
• Iran - Added support for Iranian holidays

Major Features

• Brazil now supports Black Consciousness Day
• Enhanced Canada support with Nunavut Day for Nunavut province
• Ireland adds Saint Brigid's Day support
• Mexico includes new Transmission of Federal Executive Power Holiday
• Poland now includes Christmas Eve as a public holiday starting 2025

Notable Improvements

• Better handling of substitute holidays and observance classifications
• Dropped PHP 8.0 support, added PHP 8.4 compatibility
• Enhanced documentation and code quality
• Extensive fixes for Ireland, Scotland, Ukraine, Mexico, Portugal, and Germany

New Contributors ❤️

• @attepulkkinen made their first contribution
• @dependabot[bot] made their first contribution
• @fbett made their first contribution
• @hamrak made their first contribution
• @mtbossa made their first contribution
• @thrashzone13 made their first contribution

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.

Implemented Enhancements

• Mexico Provider #329 (Luis Gonzalez).
• From 2024, Romania will officially include the holidays of St. Johns ('Sfântul Ioan Botezătorul') and Epiphany ('Bobotează'). #310 (AngelinCalu)
• For the German state of Mecklenburg-Western Pomerania, International Women's Day is considered to be officially observed. #311 (ihmels)
• Recently, the South Korean government announced a bill to apply alternative public holidays to Buddha's Day and Christmas Day. #314 (barami)
• Refactor the rules for calculating holidays in South Korea based on the history of holiday changes. (#314) barami
• Update links to related documentation in the South Korea provider's note and added links to conversion utilities. #314 (barami)
• Optimize the method for the Emperor's birthday calculation in Japan.
• For Croatia, extract Day of Antifascist Struggle calculation to a private method and simplify Statehood Day calculation to make it more concise.
• Simplify the conditions for the Coming of Age day (Japan) calculation.
• Simplify the calculation of Carnival in Argentina, Brazil and the Netherlands to reduce duplication.

Resolved Issues

• For South Korea, some of the past dates for Buddha's Day, Chuseok, Armed Forces Day and United Nations Day were incorrectly calculated during for certain periods. #314 (barami)
• The holiday twoDaysLaterNewYearsDay of South Korea has been removed from 1990, however the unit test for the name and holiday type allowed the possible testing range to include the year 1990.
• New Years Day tests for South Korea were failing due to incorrect date checks.
• The Easter Date calculation resulted in wrong values for the year 2025, due to an incorrect rounding for the lunar correction when the calendar extension is not used. #326 (rChassat)

Removed

• Denmark will abolish Great Prayer Day ('store bededag') from 2024. #308 (c960657)
• Summertime and Wintertime in the Netherlands and Denmark as these can't be reliably established for historical dates and aren't true holidays in the context of Yasumi. Refer to this discussion for further details and rationale. #322
• PHP 7.4 support.

New Contributors

• @ihmels made their first contribution in https://github.com/azuyalabs/yasumi/pull/311
• @rChassat made their first contribution in https://github.com/azuyalabs/yasumi/pull/326
• @gogl92 made their first contribution in https://github.com/azuyalabs/yasumi/pull/329

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.

Implemented Enhancements

• Bank holiday for King Charles III’s Coronation in the United Kingdom. #305 (Freshleaf Media)
• Bank holiday for Queen Elizabeth II’s State Funeral on September 19, 2022, for the United Kingdom. #287 (Freshleaf Media)
• National Day of Mourning for Australia. #288 (FuzzyWuzzyFraggle).
• In Japan, Marine Day was rescheduled to July 23 as the 2020 Tokyo Olympics took place. The rescheduled Marine Day for 2021 was included, but not the original rescheduled day for 2020.
• Slovak translations for a couple of popular holidays. #298 (Jozef Grencik)

Resolved Issues

• Liberation Day for The Netherlands is only an official holiday every 5 years #280 (Daan Roet).
• Pentecost Monday in France was only recognized as an official holiday until 2004. Since 2004, it is considered a special holiday, a so called 'working holiday'. Hence, it is therefore classified as an observed holiday in Yasumi from 2004 and forward. #281.
• The holiday of Epiphany (6th of January) was incorrectly categorized as other and changed to an official holiday in Baden-Württemberg, Bavaria and SaxonyAnhalt. #296 (Anna Damm).
• The year 1988 was incorrectly omitted from observing the Emperor's birthday in Japan.
• The tests for Remembrance Day, Malvina's Day and National Sovereignty Day in Argentina were considered for all years; however, these have only been celebrated since their establishment.
• Tests for New Year's Day, Spring Bank Holiday, and May Day Holiday in the United Kingdom (England, Wales, Northern Ireland, and Scotland), as well as Battle of the Boyne in Northern Ireland, were considered for any calendar year; however, these are celebrated only since a particular calendar year.
• In version 2022f of the tz db, a correction for 1947 was made for the summertime transition in Denmark to April the 6th. Various corrections have been made to accommodate for change.

New Contributors

• @jwojtyra-aterian made their first contribution in https://github.com/azuyalabs/yasumi/pull/277
• @DRoet made their first contribution in https://github.com/azuyalabs/yasumi/pull/280
• @freshleafmedia made their first contribution in https://github.com/azuyalabs/yasumi/pull/287
• @jozefgrencik made their first contribution in https://github.com/azuyalabs/yasumi/pull/298
• @AnnaDamm made their first contribution in https://github.com/azuyalabs/yasumi/pull/297
• @FuzzyWuzzyFraggle made their first contribution in https://github.com/azuyalabs/yasumi/pull/288
• @SupraSmooth made their first contribution in https://github.com/azuyalabs/yasumi/pull/292
• @tylershuster made their first contribution in https://github.com/azuyalabs/yasumi/pull/282

Full Changelog: https://github.com/azuyalabs/yasumi/compare/2.5.0...2.6.0

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.

Implemented Enhancements

• Argentina Provider #264 (Nader Safadi).
• Turkey Provider #250.
• World Children's Day for Thuringia (Germany) #260.
• New National Day for Truth and Reconciliation to Canada #257 (Owen V. Gray).
• New Juneteenth National Independence Day to USA #253 (Mark Heintz).
• The Korea Tourism Organization's holiday guide link was added to the source of South Korea Provider #255 (barami).
• Mothering Day for the United Kingdom #266.
• Revised rules to calculate substitution holidays of South Korea to apply the newly enacted law on June 2021 #255 (barami).
• Separate calculateSubstituteHolidays method of South Korea Provider to calculateSubstituteHolidays and calculateOldSubstituteHolidays #255 (barami)
• Refactored the tests of South Korea provider to testing substitution holidays #255 (barami).
• Moved the United Kingdom Spring Bank Holiday to June 2nd and added Platinum Jubilee bank holiday on June 3rd for 2022 #270 (Dan).

Resolved Issues

• All Saints Day (German: 'AllerHeiligen') was classified as Other for states celebrating this day. This was incorrect (or officially changed) and has been altered to Official #263.
• Corpus Christi (German: 'Fronleichnam') was classified as Other for states celebrating this day. This was incorrect (or officially changed) and has been altered to Official #252.
• The test for the USA in that juneteenthDay was considered for all years: it is only celebrated since 2021.
• Definition of Canada Day in Canada in that, Canada Day is July 1 if that day is not Sunday, and July 2 if July 1 is a Sunday #257 (Owen V. Gray).

Removed

• PHP7.3 Support as it is End of Life.

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.

Implemented Enhancements

• Georgia Provider #245 (Zurab Sardarov)
• Pentecost (Sunday) to Germany #225 (Patrick Root)
• Rescheduled exceptional Japanese holidays for Olympic Games 2020 after COVID-19 #240 (tanakahisateru)
• Some improvements/refactoring of the Swiss holiday providers (including links to sources) #233 (Quentin Ligier)
• Allow the WEEKEND_DATA constant in provider classes to be overridden. #235 (Mahmood Dhia)
• Travis/StyleCI/Scrutinizer services replaced by Github Actions.
• PHP8 Support #238 (Stéphane)
• Added Infection PHP to perform mutation testing.
• Added PHPStan to the dependencies allowing for local analysis.
• Removed PHP 7.2 Support (PHP 7.2 is EOL)
• Removed Faker library as it has been sunset #238 (Stéphane)
• .gitattributes file to reduce the size of a release package #237 (Stéphane)

Resolved Issues

• The test for North West Territories (Canada) in that the National Indigenous Peoples Day was considered for all years: it is only celebrated since 1996.
• The test for NovaScotia (Canada) in that novaScotiaHeritageDay was considered for all years: it is only celebrated since 2015.
• The test for Ontario (Canada) in that IslanderDay was considered for all years: it is only celebrated since 2009.
• The test for Marine Day (Japan) as the rescheduled day was moved to 2021 (due to the COVID-19 pandemic).
• Typo for Estonian Day of Restoration of Independence #228 (Reijo Vosu)
• The substitute holiday unit test as the use of the at() method will be deprecated in PHPUnit 10.
• Incorrect invocation of 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 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.

Implemented Enhancements

• Added Canada Provider #215 (lux)
• Added Luxembourg Provider #205 (Arkounay)
• Holiday providers for states of Austria. #182 (aprog)
• Added All Souls Day to Lithuania #227 (norkunas)
• Catholic Christmas Day is a new official holiday since 2017 in the Ukraine. #202
• Additional Dates for Australia/Victoria:AFL Grand Final Friday #190 (brucealdridge)
• Substituted holidays (holidays that fall in the weekend) for Australia. #201 (c960657)
• Added New Years Eve to Germany #226 (Patrick-Root)
• Day of Liberation (Tag der Befreiung) is a one-time official holiday in 2020 in Berlin (Germany).
• Catalan translations for holidays in Catalonia, Valencian Community, Balearic Islands and Aragon #189 (c960657)
• Added American English spelling for Labour Day #216
• Added French translation for Second Christmas Day #188 (Arkounay)
• Renamed the Australian states to be full names instead of abbreviations to be in line with other Holiday Providers #214
• Statehood Day is celebrated at a new date since 2020 in Croatia. #203 (krukru)
• Independence Day is no longer an official holiday since 2020 in Croatia. #203 (krukru)
• Homeland Thanksgiving Day has been renamed to "Victory and Homeland Thanksgiving Day and the Day of Croatian Defenders" since 2020 in Croatia. #203 (krukru)
• Remembrance Day for Homeland War Victims and Remembrance Day for the Victims of Vukovar and Skabrnja is a new official holiday since 2020 in Croatia. #203 (krukru)
• Second International Workers Day in Ukraine was an official holiday only until 2018. #202
• Holiday names in Danish, Dutch, and Norwegian are no longer capitalized. #185 (c960657)

Resolved Issues

• Fixed Ukraine holidays on weekends. These days need to be substituted. #202
• Fixed issue if the next working day happens to be in the next year (i.e. not in the year of the Yasumi instance) #192 (tniemann)
• Fix locale fallback for substitute holidays #180 (c960657)
• Fixed issue if the previous working day happens to be in the previous year (i.e. not in the year of the Yasumi instance)
• Fixed compound conditions that are always true by simplifying the condition steps.

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.

Implemented enhancements

• Holiday providers for England, Wales, Scotland and Northern Ireland #166 (c960657)
• Holiday Provider for South Korea. #156 (blood72)
• Translation for the Easter holiday for the 'fr_FR' locale #146 (pioc92)
• Translation for the Pentecost holiday for the 'fr_FR' locale #145 (pioc92)
• Late Summer Bank Holiday in United Kingdom prior to 1965 #161 (c960657)
• Observance holidays for Sweden #172 (c960657)
• Updated the translation for the All Saints holiday for the 'fr_FR' locale #152 (pioc92)
• Updated the translation for the Armistice holiday for the 'fr_FR' locale #154 (pioc92)
• Updated the translation for the Victory in Europe holiday for the 'fr_FR' locale #153 (pioc92)
• Updated the translation for the Assumption of Mary holiday for the 'fr_FR' locale #155 (pioc92)
• Updated the translation for Christmas Day for the 'nl_NL' locale #160 (pioc92)

Resolved issues

• Late Summer Bank Holiday in 1968 and 1969 in United Kingdom #161 (c960657)
• Fixed one-off exceptions for May Day Bank Holiday in 1995 and 2020 and Spring Bank Holiday in 2002 and 2012 (United Kingdom) #160 (c960657)
• Fixed revoked holidays in Portugal in 2013-2015 #163 (c960657)
• Fixed spelling issues in the Danish translation for Second Christmas Day. #167 (c960657)
• Corpus Christi is official in Poland #168 (c960657)
• Liberation Day is official in the Netherlands #169 (c960657)
• Typos in Easter Monday and Republic Day for the 'it_IT' locale #171 (c960657)
• Good Friday is not official in Brazil #174 (c960657)

A couple of months after the successful v2 release, a new minor release is available as of today. Yasumi v2.1 addresses mostly a few issues for the Japan Holiday Provider and some other bug fixes.

Implemented enhancements

• As the Japanese Emperor will abdicate the throne on May 1st 2019, the holiday of the Emporers Birthday will change to February 23rd from 2020 (No holiday in 2019). In addition, Coronation Day and the Enthronement Proclamation Ceremony will be extra holidays in 2019. #130 (cookie-maker)
• International Women's Day is an official holiday since 2019 in Berlin (Germany). #133 (huehnerhose)

Resolved issues

• Japanese Health And Sports Day will be renamed to Sports Day from 2020. #129 (cookie-maker)
• Dutch spelling for Easter/Pentecost/Christmas to use lower case. #128 (c960657)
• Refactored the Netherlands Holiday provider by moving the calculation of individual holidays to private methods. This will reduce the complexity of the initialize method.
• Visibility of internal class functions to 'private'. These are to be used within the class only and should not be public.
• "Bridge Day" for Japan takes two days in 2019. Currently the code only allows for 1 bridge day at a maximum. #141 (cookie-maker)
• Tests for Bremen, Lower Saxony and Schleswig Holstein (Germany) also celebrated Reformation Day in 2017. The unit tests were failing as it didn't account for that.
• Changed the USA Provider to check all holidays for potential substitute holidays, not just New Year's Day, Independence Day, and Christmas Day. #140 (jagers)
• Adjusted tests for the 'next' and 'previous' methods to avoid actually exceeding the year boundaries.
• Deprecation warning for the package mikey179/vfStream. Composer 2.0 requires package names to not contain any upper case characters. #135 (IceShack)
• Incorrect comment about weekends in India #126 (c960657)
• Correction to the test of New Year's day in the United Kingdom. It has been identified as a Bank Holiday only since 1975 (not from 1974).
• Duplicate definition of newYearsDay #125 (c960657)

Almost a year has passed since the release of v1.8.0, but finally it is here: Yasumi v2.0.0!

Upgraded entirely to PHP version 7 with PHP 7.1 being the minimum required version. Base code and all unit tests have been reworked to compatibility with PHP 7. This also means support of PHP 5 has now come to an end.

More details can be found in the blog entry here: Welcome Yasumi version 2!

Implemented enhancements

• New filter to select holidays that happen on a given date #119 (cruxicheiros)
• Holiday Providers for all Australian states and territories. #112 (Milamber33)
• Holiday Provider for Bosnia. #94 (TheAdnan)
• Added Reformation Day as official holiday since 2018 in Lower Saxony (Germany). #115 (Taxcamp)
• Added Reformation Day as official holiday since 2018 in Schleswig-Holstein (Germany). #106 (HenningCash)
• Added Reformation Day as official holiday since 2018 in Hamburg (Germany). #108 (HenningCash)
• Added Reformation Day as official holiday since 2018 in Bremen (Germany). #116 (TalonTR)
• The (observed) holidays Lukkeloven, Constitution Day, New Year's Eve and Labour Day, as well as summertime and wintertime are included for Denmark #104 (c960657)
• Upgraded to PHPUnit to version 7.5.
• Changed Japanese holiday for the 2020 Olympic Games. Marine Day, Mountain Day and Health And Sports Day. #113 (cookie-maker)
• Summer/winter time is now fetched from PHP's tz database. #103 (c960657)
• Changed translation for Norway's national day. #98 (c960657)
• Applied proper null checks in the summertime and wintertime calculations for Denmark and The Netherlands.
• Corrected some namespaces for Australia and Germany.
• Updated copyright year.
• Upgraded various dependency packages.
• Internal locale list updated based on CLDR v34.
• Refactored the Japan and USA Holiday Provider by moving the holiday calculations to private methods. This reduced the complexity of the initialize method.

Resolved issues

• Translation for Russia showed in English (except New Year's Day) as the proper locale was not in place.
• Fixed issue for summertime in Denmark in 1980. By default summertime in Denmark is set for the last day of March since 1980, however in 1980 itself, it started on April, 6th.
• Fixed spelling issue in the Swedish translation. #97 (c960657)
• Fixed spelling issues in the Danish translation. #96 (c960657)
• Fixed German Easter Sunday and Pentecost Sunday holidays (not nationwide, only in Brandenburg). #100 (TalonTR)
• Fixed BetweenFilter to ignore time part and timezone. #101 (c960657)
• Fixed bug in provider list generation related to variable order of files returned by the filesystem #107 (leafnode)

Yasumi version 2.0 has been released (and v1.8.1)!

With the release of Yasumi v2.0.0 supporting only PHP version 7.1 (or higher), support for PHP 5 in Yasumi has ended (Sorry!).

This 1.8.1 bug fix release has been made available for those that still are on PHP 5 (or are in the process of upgrading to PHP 7). It only includes some serious/critical bug fixes discovered since version 1.8.0 and no new countries have been added for example.

Please be aware that all new development will be done from v2.0.0 onwards (in the 'develop' branch). The 'support/1.8.x' branch has been created for critical bug fixes only.

Changes

• Added PHP 7.2 and 7.3 to the TravisCI configuration.
• Changed Japanese holiday for the 2020 Olympic Games. Marine Day, Mountain Day and Health And Sports Day. #113
• Changed translation for Norway's national day. #98

Resolved issues

• Except New Years Day, all holidays for Russia didn't have the locale parameter in place, causing Yasumi to use the fallback locale ('en_US').
• Fixed spelling issue in the Swedish translation. #97
• Fixed spelling issues in the Danish translation. #96
• Fixed German Easter Sunday and Pentecost Sunday holidays (not nationwide, only in Brandenburg). #100
• Fixed BetweenFilter to ignore time part and timezone. #101
• Fixed bug in provider list generation related to variable order of files returned by the filesystem #107
• Fixed issues that assertNotHoliday() skips rest of test
• Type cast to integer as Yasumi::create() requires an integer.
• Changed access to static variables with 'self'. Accessing with 'static' can lead to possible sub-classes.
• Corrected date parameter to be of DateTime (instead of DateTimeInterface) as the parameter object needs to be a direct instance.
• Changed way to get current year so value is an integer (as required by the class). PHP's date function is intended for formatting and returns a string type as such.
• Corrected test using different start year to avoid incorrect assertion.

Yasumi v1.8.0 is now available as of Wednesday, February 21st supporting Russia and Estonia thanks to the work of Gedas Lukošius.

As already announced in my previous post, 1.8.0 will be the last release to officially support PHP5.x. I think it's about time that Yasumi will fully support PHP7 using its performance improvements.

Next to Russia and Estonia being part of the family, 1.8.0 includes a good number of fixes and changes as well.

Implemented enhancements:

• Added a function that can remove a holiday from the holidays providers (i.e. country/state) list of holidays. This function can be helpful in cases where an existing holiday provider class can be extended but some holidays are not part of the original (extended) provider.
• Changed various functions that have a date parameter to support now objects implementing the DateTimeInterface and objects of the DateTimeImmutable type.
• Added support for countries where the weekend definition (start and end day) differs from the global definition (Saturday and Sunday).
• Holiday Provider for Russia. #72 (lukosius)
• Holiday Provider for Estonia. #71 (lukosius)
• Added Scrutinizer integration.
• Locale List updated based on CLDR version 32.
• Added PHPStan static analysis tool to Travis CI #88 (lukosius)
• Various inline documentation enhancements. #87 (lukosius)
• Removed unnecessary typecasts and if-construct. #87 (lukosius)
• Updated inline documentation to include correction Exception throws.
• Removed unnecessary NULL checks.

Resolved Issues:

• Fixed Brazilian Carnaval Day and added Ash Wednesday to Brazilian Holidays. #92 (glauberm)
• Yasumi listed 01.04.2018 (Easter Sunday) for Spain as an official holiday, however it is not recognized as such. Fix made that recognizes Easter Sunday as being observed (in all regions). #86 (Bastian Konetzny)
• Corrected reference to the Holiday Provider's ID to be static.
• Changed weekend data property into constant as it is not dynamic (runtime).
• Corrected the name translation test for the Restoration of Independence Day (Portugal). The test didn't account for the fact that this holiday was abolished and reinstated at some time.
• Corrected unit test for Geneva (Switzerland) as the jeune Genevois day was incorrectly asserted as a regional holiday.
• Corrected the count logic so that in case a holiday is substituted (or observed), it is only counted once.
• Dropped unnecessary arguments of some methods in various Holiday Providers.
• Corrected Japanese "Green Day" and "Children's Day" to use "Hiragana" instead of Kanji. #80 (cookie-maker)

A new release was long overdue and v1.7.0 has some nice enhancements... Four new countries have been added (Latvia, Lithuania, Hungary and Switzerland) making the total of holiday providers 96! (31 countries and 65 sub-regions).

Instead of giving the country name as a parameter, you can now also use the ISO3166_2 code to instantiate a Holiday object, which in some cases makes more sense. Also, all filters implement the Countable interface so you can use the ->count() method, which will return the correct number of (filtered) holidays.

Heads up! v1.7.0 will be the last release supporting PHP5.x. PHP7 has been out for a long time and Yasumi can definitely benefit from the new features in PHP7. Likely the PHP7 only branch will start as v2.0.0.

As always a big thanks to all the contributors!

Implemented enhancements:

• Holiday Provider for Latvia. #70 (lukosius)
• Holiday Provider for Lithuania. #67 (lukosius)
• Holiday Provider for Hungary. #57 (AronNovak)
• Holiday Provider for Switzerland. #56 (qligier)
• All filters implement the Countable interface allowing you to use the ->count() method. #77
• Sometimes it is more convenient to be able to create a Yasumi instance by ISO3166 code rather than Yasumi's Holiday Provider name. A new function createByISO3166_2 has been added to allow for that. #62 (huehnerhose)
• Missing translations (de_DE) for Easter Sunday and Whitsunday. #60 (IceShack)
• Made calculate method public and use of proper camel casing. #73 (patrickreck)
• Upgraded Faker Library to version 1.7
• Renamed the holiday type NATIONAL to OFFICIAL. Subregions may have official holidays and the name NATIONAL doesn't suit these situations. #65
• Upgraded PHP-CS-Fixer to version 2.6

Resolved Issues:

• Corrected Geneva (Switzerland) unit test to ensure some holidays that are established at a particular year are handled as such.
• Repentance Day is an official holiday in Saxony (Germany) #63
• Corrected the Easter Sunday translation for Austria (de_AT) #66
• Corrected Hungary unit test to ensure holidays that are established at a particular year are handled as such.
• Added missing Summer Bank Holiday for the United Kingdom. #64

This bugfix release addresses some minor annoying issues, so unfortunately no new features this time.

Implemented enhancements:

• Moved Reformation Day to Christian Holidays as it is not only celebrated in Germany.
• Added missing unit tests for the German Unit Day for each German state.

Resolved issues:

• Fixed Christmas Day and Boxing Day for the United Kingdom. A substitute bank holiday is now created for both Christmas and Boxing Day when either of those days fall on a weekend. #48 (joshuabaker)
• Renamed 'en_US' translation for the Second Christmas Day (from ‘Boxing Day’ to ‘Second Christmas Day’: Boxing Day concept does not exist in the US). #53 (AngelinCalu)
• Created fallback calculation of the easter_days function in case the PHP extension 'calendar' is not loaded. #55 (stelgenhof)
• Added missing unit tests for Reformation Day as in 2017 it is celebrated in all German states for its 500th anniversary.
• Changed Travis configuration to use Composer-installed phpunit to avoid if any issues arise with globally installed phpunit.

We start the new year with a new release, in which we welcome Austria, Ireland, Romania and South Africa to the Yasumi family. Also Yasumi hit the 8000 mark in the first week of 2017: over 8000 times Yasumi has been installed already!

Again, thank you all for your contributions and fixes!

Implemented enhancements:

• Added Holiday Provider for Romania. #52 (AngelinCalu)
• Added Holiday Provider for Ireland. stelgenhof
• Added Holiday Provider for South Africa. stelgenhof
• Added Holiday Provider for Austria. stelgenhof
• Refactored the calculation of Orthodox Easter using the function from ChristianHolidays.php. #47 (AngelinCalu)
• Added 'en_US' translations for the Polish Independence Day and Constitution Day. #45 (AngelinCalu)

Resolved issues:

• The parameters of the isHoliday and isWorkingDay methods now allow for classes that derive from DateTime (like the very popular Carbon class). #49 (stelgenhof)

Being occupied with other projects is good but has the side effect some others don't get the attention they deserve (sorry Yasumi). However, happy to announce a new release of Yasumi with 4 new countries added and holiday providers for all the German states.

Yasumi now supports 62 holiday providers (23 countries and 39 sub-regions) and has over 1500 unit tests ensuring all holidays are calculated correctly.

Big thanks to all the contributors making Yasumi better and more complete!

Implemented enhancements:

• Added Holiday Provider for Australia (and the sub-region of Victoria). #38 (brucealdridge)
• Added Holiday Provider for Portugal. #44 (rvelhote)
• Added Holiday Provider for Ukraine. #41 (madmis)
• Added Holiday Providers for all 16 German States. #34 (stelgenhof)
• Added Holiday Provider for Croatia. #32 (karlomikus)
• Possibility to retrieve the next or previous working day within a defined number of days from today #39 (brucealdridge)
• You can now also use your own holiday providers in addition to the included holiday providers. A very helpful improvement if Yasumi does not include your provider (yet), but you want to use yours! #29 (navarr)

Resolved issues:

• Carnival Day in Brazil was incorrectly set to be 47 days after Easter. Carnival Day begins Friday before Ash Wednesday (51 days to Easter). #36 (icaroce)
• All Saints Day for Finland was incorrectly set for November 1st. The correct date is Saturday between 31 Oct and 6 Nov, similar to Sweden. #43 (stelgenhof)

Implemented enhancements:

• Added Holiday Provider for Brazil. #21 (dorianneto)
• Added Holiday Provider for the Czech Republic. #26 (dfridrich)
• Added Holiday Provider for the United Kingdom. #23
• Add Welsh language (spoken in Wales, UK) translations for the holidays in the United Kingdom #25 (meigwilym)
• All Holiday Provider must now implement a code that will identify it. Typically this is the ISO3166 code corresponding to the respective country or subregion. This can help for purposes such as translations or interfacing with other API's for example.
• To determine a set of holidays between two dates you can now use the aptly named 'between()' method.

Resolved issues:

• Fixed an issue with the unit test for the 'getProviders' method failing on Windows. Hardcoded unix-style directory separators have been replaced by DIRECTORY_SEPARATOR. #30 (navarr)
• Corrected a typo in the English translation for 敬老の日 (Japan) #22 (navarr)
• Fixed issue that the unit tests in 'YasumiTest' (methods 'next' and 'previous') didn't cover the situations that the limits are exceeded. #28

Implemented Enhancements

• Added Holiday Provider for Poland. #18 (mpdx)
• Added Holiday Provider for New Zealand. #13 (badams)
• Added Holiday Provider for Greece. #10 (sebdesign)
• Added Holiday Provider for Germany. #9 (eaglefsd)
• Added translations ('fr_FR', 'fr_BE') for Belgium National day #864d250 (R2c)
• Sorted all translations in the translation files alphabetically (descending).
• Added missing English ('en_US') translations for the Christian holidays 'Immaculate Conception', 'Maundy Thursday', 'St. Georges Day', 'St. John's Day', 'St. Josephs Day' and 'St. Stephens Day'.
• Added Test Interface class to ensure the unit tests contain a some minimal assertions.
• Refactoring and cleanup of all unit tests.

Resolved Issues

• Fixed issue for Sweden as All Saints Day was always calculated to be on November 1st. However the holiday has always been celebrated on a Saturday (between October 31 and November 6th).
• Fixed the getProviders as it was not able to load Holiday Providers defined in (sub) regions #5879133 (R2c)
• Fixed issue that it was possible for the AbstractProvider class to be loaded as a Holiday Provider #9678bc4 (R2c)
• Corrected incorrect pathname reference *BaseTestCase.php files ("Test" -> "test).
• Fixed issue for France as Good Friday and St. Stephens Day were defined as official holidays. These aren't national holidays and are only observed in the French departments Moselle, Bas-Rhin and Haut-Rhin. With this fix, these holidays have been removed from the France Holiday providers and new providers for the departments Moselle, Bas-Rhin and Haut-Rhin are added. #17 (R2c)
• Updated locales list based on CLDR version 29. Removed locales of which the region identifier is not specified.
• Fixed issue for Sweden as Midsummer's Day (st. Johns Day) was always calculated to be on June 24th. However the holiday has always been celebrated on a Saturday (between June 20 and June 26).
• Fixed base test for some Spain/LaRioja as some holidays have been established only in a particular year, causing false failures in the unit tests.
• Running php-cs-fixer fix . --level=psr2 generated a massive list of changes, and broke unit tests. Added a custom .php_cs config file to adhere to the PSR-2 Coding Standards and resolve this issue. In addition the php-cs-fixer command to has been added to composer to run the fixers and on the CI server (Travis), meaning PR’s will need to be PSR2 compliant before they can be merged. If any files do not pass, the build fails. #15 #16 (badams)
• Accidentally the timezone for Norway was set to "Europe/Copenhagen". This has been corrected to "Europe/Oslo". #11 #12 (badams)
• Fixed issue for Finland as Midsummer's Day (st. Johns Day) was always calculated to be on June 24th. However since 1955, the holiday has always been celebrated on a Saturday (between June 20 and June 26).

Implemented Enhancements

• Added Holiday Provider for Denmark
• Added Holiday Provider for Norway
• Added Holiday Provider for Sweden
• Added Holiday Provider for Finland
• New function 'isWorkingDay' added that determines whether a date represents a working day or not. A working day is considered a date that is neither a holiday nor falls into the weekend.
• Refactoring and cleanup of unit tests

Closed Issues

• The Vernal Equinox Day and Autumnal Equinox Day in Japan were excluded from having it substituted for another day in case these days would fall on the weekend.
• Fixed tests for some holiday providers as some holidays have been established only in a particular year, causing false failures in the unit tests.

Implemented Enhancements

• Added Spain Holiday Driver (including the autonomous communities Andalusia, Aragon, Asturias, Balearic Islands, Basque Country, Canary Islands, Cantabria, Castile and León, Castilla-La Mancha, Ceuta, Community of Madrid, Extremadura, Galicia, La Rioja, Melilla, Navarre, Region of Murcia, Valencian Community)
• Added Corpus Christi, St. Joseph's Day, Maundy Thursday, St. George's Day, St. John's Day to the common Christian Holidays.
• Updated some English, Italian, French and Dutch translations.
• Created separate tests for holidays that are substituted on different days.
• Moved all other holiday calculations in Netherlands and France to individual methods.
• Allow for name spaced holiday providers.
• Added test for translation of Ash Wednesday and Valentinesday in the Netherlands.
• Added test to check whether all holidays for a Holiday Provider are defined by the respective provider class.
• Removed support for PHP 5.4. Minimum version is now 5.5. PHP 7.0 is known to work however in Travis CI still allowed to fail

Closed Issues

• Fixed issue for Japan where substituted holidays had same date as the original holidays.

Welcome to the first public version of Yasumi! Yasumi is an easy PHP library to help you calculate the dates and names of holidays and other special celebrations from various countries/states.