Yasumi Versions Save

The easy PHP Library for calculating holidays

2.7.0

4 months ago

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

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

2.6.0

1 year ago

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

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

2.5.0

2 years ago

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.

2.4.0

3 years ago

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)

2.3.0

3 years ago

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.

2.2.0

4 years ago

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)

2.1.0

5 years ago

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)

2.0.0

5 years ago

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 offical holiday since 2018 in Lower Saxony (Germany). #115 (Taxcamp)
  • Added Reformation Day as offical holiday since 2018 in Schleswig-Holstein (Germany). #106 (HenningCash)
  • Added Reformation Day as offical holiday since 2018 in Hamburg (Germany). #108 (HenningCash)
  • Added Reformation Day as offical 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)

1.8.1

5 years ago

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.

1.8.0

6 years ago

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)