diff --git a/README.md b/README.md index 3d4b581..f2be980 100644 --- a/README.md +++ b/README.md @@ -158,6 +158,8 @@ We'd be very thankfull! ## Comparison +#### Yasumi + The main other library in the PHP-ecosystem that also provides holiday-calendars is the [Yasumi-library](https://packagist.org/packages/azuyalabs/yasumi). There are some differences between those two libraries though that I want to highlight here. @@ -185,6 +187,27 @@ available this library requires the DOM-extension (XML) as well as the INTL-exte holidays based on different calendaring systems. This library also requires a library to compare dateintervals which is used in the calculation of the easter-date. +#### Calendarific + +[Calendarific](https://calendarific.com) is an SaaS Provider that provides worldwide Bank-Holidays and Observances via +An API. + +They are currently supporting all countries worldwide. Their API can be queried for holiday information on a per country +and year basis. It is possible to only fetch information to a sub-area of a country (like states in the US or Kantone +in Switzerland). YOu can also just check one specific day by providing the day and the month along with the year. + +As the pricing of the API limits the number of API calls per month, calling the API on a per-day basis migth not be the +best of ideas. Also the API provides information for either local, national or religious holidays as well as observances +(where observances in one region can be national or regional holidays in another region). Sadly it seems not to be +possible to fetch only regional and national holidays in one request. It is either all of them or only a single one. +And as the "observation" type is rather chatty (it contains a lot of special dates that might or might not have any +relevance at all - like astronomical observations that might be calculated better using separate libraries) + +So as consumer it requires a lot of work afterwards to get the actualy required data when wanting to get the information +whether a certain day is a holiday in the requested area or not. + +It serves a purpose and is readily available. At a price. + ### Missing Features #### Business-Days