{"id":18909961,"url":"https://github.com/jonasbn/perl-date-holidays-super","last_synced_at":"2025-07-09T07:09:52.132Z","repository":{"id":19246007,"uuid":"22481251","full_name":"jonasbn/perl-date-holidays-super","owner":"jonasbn","description":"Release history of Date-Holidays-Super","archived":false,"fork":false,"pushed_at":"2025-04-22T05:31:35.000Z","size":156,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-09T07:08:41.065Z","etag":null,"topics":["cpan","date-holidays","hacktoberfest","perl","perl5"],"latest_commit_sha":null,"homepage":"http://search.cpan.org/dist/Date-Holidays-Super/","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonasbn.png","metadata":{"files":{"readme":"README.md","changelog":"Changes","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-07-31T19:05:36.000Z","updated_at":"2025-04-22T05:31:37.000Z","dependencies_parsed_at":"2025-03-22T18:21:34.288Z","dependency_job_id":"415f199b-56f7-4fdc-8892-01f7e72fc7c4","html_url":"https://github.com/jonasbn/perl-date-holidays-super","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/jonasbn/perl-date-holidays-super","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fperl-date-holidays-super","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fperl-date-holidays-super/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fperl-date-holidays-super/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fperl-date-holidays-super/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonasbn","download_url":"https://codeload.github.com/jonasbn/perl-date-holidays-super/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fperl-date-holidays-super/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264411163,"owners_count":23603804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpan","date-holidays","hacktoberfest","perl","perl5"],"created_at":"2024-11-08T09:38:49.478Z","updated_at":"2025-07-09T07:09:52.115Z","avatar_url":"https://github.com/jonasbn.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CPAN version](https://badge.fury.io/pl/Date-Holidays-Super.svg)](https://metacpan.org/pod/Date::Holidays::Super)\n[![Build Status](https://github.com/jonasbn/perl-date-holidays-super/actions/workflows/ci.yml/badge.svg)](https://github.com/jonasbn/perl-date-holidays-super/actions/workflows/ci.yml)\n[![Coverage Status](https://coveralls.io/repos/github/jonasbn/Date-Holidays-Super/badge.svg?branch=master)](https://coveralls.io/github/jonasbn/Date-Holidays-Super?branch=master)\n\n# NAME\n\nDate::Holidays::Super - a SUPER class for the Date::Holidays::\\* modules\n\n# SYNOPSIS\n\n        package MyHolidays;\n\n        use Date::Holidays::Super;\n        use vars qw(@ISA);\n\n        @ISA = qw(Date::Holidays::Super);\n\n        my $mh = MyHolidays-\u003enew();\n\n        my $bool = $mh-\u003eis_holiday( ... );\n\n        my $hashref = $mh-\u003eholidays( ... );\n\n# VERSION\n\nThis POD described version 0.03 of Date::Holidays::Super\n\n# DESCRIPTION\n\nThis is a SUPER class intended for use by Date::Holidays::\\* modules.\n\nThe goal is to have all the existing and future modules implement the\nsame methods, so they will have a uniform usage and can be used in\npolymorphic context or can be easily adapted into the Date::Holidays\nclass.\n\nThe class provides two methods: **is\\_holiday** and **holidays** an\nalternative to this class is Date::Holidays::Abstract, which does not\nimplement these methods, but require that they are implemented.\n\nIf you want to use Date::Holidays::Super and want to comply with my\nsuggestions to the methods that ought to be implemented, you should\noverload the methods provided by this class, when and if you have the\ntime in your Date::Holidays::\\* module.\n\n- is\\_holiday\n- holidays\n\n# SUBROUTINES/METHODS\n\n## is\\_holiday\n\nShould at least take 3 arguments:\n\n- year, four digits\n- month, between 1-12\n- day, between 1-31\n\nThe return value from is holiday is either a 1 or 0 indicating true of\nfalse, indicating whether the specified date is a holiday in the given\ncountry's national calendar.\n\n**is\\_holiday** in the SUPER class returns 0 indicating false, since\nnothing intelligent can be said about holidays without specifying a\nnational calendar.\n\nAdditional arguments are at the courtesy of the author of the using\nmodule/class.\n\n## holidays\n\nShould at least take one argument:\n\n- year, four digits\n\nReturns a reference to a hash, where the keys are date represented as\nfour digits. The two first representing month (01-12) and the last two\nrepresenting day (01-31).\n\nThe value for the key in question is the local name for the holiday\nindicated by the day. The result set will of course vary depending on\nthe given country's national holiday.\n\n**holidays** in the SUPER class return a reference to an empty hash,\nsince nothing intelligent can be said about holidays without specifying\na national calendar.\n\nAdditional arguments are at the courtesy of the author of the using\nmodule/class.\n\n\\--\n\n[Date::Holidays](https://metacpan.org/pod/Date%3A%3AHolidays) uses the requirements defined by this module and this\nmodule can therefor be used with success in conjunction with this.\n\nThis is an alternative to the abstract class [Date::Holidays::Abstract](https://metacpan.org/pod/Date%3A%3AHolidays%3A%3AAbstract).\n\nSuggestions for changes and extensions are more than welcome.\n\n# DIAGNOSTICS\n\nNo special exceptions/diagnostics are used at this time.\n\n# CONFIGURATION AND ENVIRONMENT\n\nNo special configuration and/or environment required\n\n# DEPENDENCIES\n\nNo dependencies at this time\n\n# INCOMPATIBILITIES\n\nNo known incompatibilities at this time\n\n# BUGS AND LIMITATIONS\n\nPlease report issues via GitHub:\n\n- [GitHub Issues](https://github.com/jonasbn/perl-date-holidays-super/issues)\n\n# SEE ALSO\n\n- [Date::Holidays::Abstract](https://metacpan.org/pod/Date%3A%3AHolidays%3A%3AAbstract)\n- [Date::Holidays](https://metacpan.org/pod/Date%3A%3AHolidays)\n- Date::Holidays::\\*\n\n# AUTHOR\n\n- Jonas Brømsø, (jonasbn) - `\u003cjonasbn@cpan.org\u003e`\n\n# LICENSE AND COPYRIGHT\n\nDate-Holidays-Super is (C) by Jonas Brømsø, (jonasbn) 2004-2021\n\nDate-Holidays-Super is released under the Artistic License 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasbn%2Fperl-date-holidays-super","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonasbn%2Fperl-date-holidays-super","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasbn%2Fperl-date-holidays-super/lists"}