{"id":13623267,"url":"https://github.com/azuyalabs/yasumi","last_synced_at":"2025-04-23T20:51:03.939Z","repository":{"id":29264515,"uuid":"32797151","full_name":"azuyalabs/yasumi","owner":"azuyalabs","description":"The easy PHP Library for calculating holidays","archived":false,"fork":false,"pushed_at":"2025-04-08T14:38:54.000Z","size":22178,"stargazers_count":1059,"open_issues_count":4,"forks_count":158,"subscribers_count":14,"default_branch":"develop","last_synced_at":"2025-04-08T23:14:56.413Z","etag":null,"topics":["api","calculate-holidays","calculating-holidays","calculations","countries","holiday","holidays","library","php","provider-holidays","yasumi"],"latest_commit_sha":null,"homepage":"https://www.yasumi.dev","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azuyalabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"custom":"https://www.buymeacoffee.com/sachatelgenhof"}},"created_at":"2015-03-24T12:28:50.000Z","updated_at":"2025-04-08T14:38:58.000Z","dependencies_parsed_at":"2024-01-30T17:42:41.227Z","dependency_job_id":"f3575af5-abdb-46a3-924f-f88d47d7efd7","html_url":"https://github.com/azuyalabs/yasumi","commit_stats":{"total_commits":1480,"total_committers":84,"mean_commits":17.61904761904762,"dds":0.4864864864864865,"last_synced_commit":"47acfc36b7e57a99fb4136c2bc9e8d96c5706d48"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azuyalabs%2Fyasumi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azuyalabs%2Fyasumi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azuyalabs%2Fyasumi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azuyalabs%2Fyasumi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azuyalabs","download_url":"https://codeload.github.com/azuyalabs/yasumi/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514752,"owners_count":21443208,"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":["api","calculate-holidays","calculating-holidays","calculations","countries","holiday","holidays","library","php","provider-holidays","yasumi"],"created_at":"2024-08-01T21:01:29.705Z","updated_at":"2025-04-23T20:51:03.920Z","avatar_url":"https://github.com/azuyalabs.png","language":"PHP","funding_links":["https://www.buymeacoffee.com/sachatelgenhof"],"categories":["PHP","目录","Table of Contents","日期和时间 Date and Time"],"sub_categories":["日期和时间 Date and Time","Date and Time","Library"],"readme":"[![GitHub Release](https://img.shields.io/github/release/azuyalabs/yasumi.svg?style=flat-square)](https://github.com/azuyalabs/yasumi/releases)\n[![Total Downloads](https://img.shields.io/packagist/dt/azuyalabs/yasumi.svg?style=flat-square)](https://packagist.org/packages/azuyalabs/yasumi)\n![Coding Standard](https://img.shields.io/github/actions/workflow/status/azuyalabs/yasumi/coding-standard.yml?label=Coding%20Standard\u0026style=flat-square)\n![Static analysis](https://img.shields.io/github/actions/workflow/status/azuyalabs/yasumi/static-analysis.yml?label=Static%20analysis\u0026style=flat-square)\n![Testing](https://img.shields.io/github/actions/workflow/status/azuyalabs/yasumi/testing.yml?label=Testing\u0026style=flat-square)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE)\n\n![Logo](https://www.yasumi.dev/assets/img/yasumi_logo.svg)\n\n## New Documentation Site 🎉\n\nYasumi's [documentation site](https://www.yasumi.dev) just got a make-over! Please check out the\n[announcement](https://github.com/azuyalabs/yasumi/discussions/358) or head straight to it.\n\n## Introduction\n\nYasumi (Japanese for 'Holiday'「休み」) is the easy PHP library that helps you retrieve the dates and names of holidays and\nother special celebrations from various countries/states. It is calculation and rule driven avoiding the need of a\ncomprehensive database.\n\nMany services exist that can provide holiday information, however are either not entirely free or only offer limited\ninformation. In addition, no exhaustive PHP library exists today covering a wide range of holidays and\ncountries. [PEAR's Date_Holidays](https://pear.php.net/package/Date_Holidays) library was a similar attempt, however it\nhasn't been updated for a long time.\n\n## Highlights\n\nThe goal of Yasumi is to be powerful while remaining lightweight, by utilizing PHP native classes wherever possible.\nYasumi's calculation is provider-based (i.e. by country/state), making it easy to add new holiday providers that\ncalculate holidays.\n\n- Pure PHP with a straightforward API\n- Framework-agnostic\n- Use of Providers to easily extend and expand new Holidays\n- Common Holiday Providers\n- Accounts for the date/time when holidays have been officially established and/or abolished\n- Filters enabling to easily select certain holiday types (Official, Observed, Bank, Seasonal or Other)\n- Global Translations\n- Time zone aware\n- Implements [ArrayIterator](https://www.php.net/manual/en/class.arrayiterator.php) to easily process a provider's\n  holidays\n- Fully [documented](https://www.yasumi.dev)\n- Fully unit tested\n- [Composer](https://getcomposer.org) ready, [PSR-12](https://www.php-fig.org/psr/psr-12/)\n  and [PSR-4](https://www.php-fig.org/psr/psr-4/) compliant\n\n## Documentation\n\nYasumi’s documentation is available on [https://www.yasumi.dev](https://www.yasumi.dev). You will find all the necessary\ninformation how to install Yasumi and also recipes how you can use Yasumi in your project.\n\n## Contributing\n\nContributions are encouraged and welcome; I am always happy to get feedback or pull requests on GitHub :)\nCreate [GitHub Issues](https://github.com/azuyalabs/yasumi/issues) for bugs and new features and comment on the ones you\nare interested in.\n\nIf you enjoy what I am making, an extra cup of coffee is very much appreciated :). Your support helps me to put more\ntime into Open-Source Software projects like this.\n\n\u003ca href=\"https://www.buymeacoffee.com/sachatelgenhof\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n\n## License\n\nThis project is open-sourced software licensed under the MIT License (MIT). Please see [LICENSE](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazuyalabs%2Fyasumi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazuyalabs%2Fyasumi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazuyalabs%2Fyasumi/lists"}