{"id":25492541,"url":"https://github.com/slavcodev/date-range","last_synced_at":"2026-02-28T06:26:04.904Z","repository":{"id":57089690,"uuid":"110966647","full_name":"slavcodev/date-range","owner":"slavcodev","description":"DateRange implementation, missing in PHP :calendar:","archived":false,"fork":false,"pushed_at":"2025-03-31T22:01:49.000Z","size":175,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-01T18:09:45.581Z","etag":null,"topics":["date-time","daterange"],"latest_commit_sha":null,"homepage":"","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/slavcodev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-16T12:05:02.000Z","updated_at":"2025-01-31T19:17:24.000Z","dependencies_parsed_at":"2023-09-30T12:31:41.857Z","dependency_job_id":"c7d0c2f4-69bc-4961-ac01-8481063f8f36","html_url":"https://github.com/slavcodev/date-range","commit_stats":null,"previous_names":["slavcodev/date-range"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slavcodev%2Fdate-range","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slavcodev%2Fdate-range/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slavcodev%2Fdate-range/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slavcodev%2Fdate-range/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slavcodev","download_url":"https://codeload.github.com/slavcodev/date-range/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248132123,"owners_count":21052977,"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":["date-time","daterange"],"created_at":"2025-02-18T22:30:48.292Z","updated_at":"2026-02-28T06:25:59.860Z","avatar_url":"https://github.com/slavcodev.png","language":"PHP","readme":"# Date Range\n\n[ico-tests-status]: https://github.com/zee/date-range/workflows/phpunit/badge.svg\n[link-github]: https://github.com/zee/date-range\n\n[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/zee/date-range.svg?logo=scrutinizer\n[ico-code-quality]: https://img.shields.io/scrutinizer/g/zee/date-range.svg?logo=scrutinizer\n[link-scrutinizer]: https://scrutinizer-ci.com/g/zee/date-range/code-structure\n[link-code-quality]: https://scrutinizer-ci.com/g/zee/date-range\n\n[ico-issues]: https://img.shields.io/github/issues/zee/date-range.svg?logo=github\n[link-issues]: https://github.com/zee/date-range/issues\n\n[ico-license]: https://img.shields.io/github/license/zee/date-range\n[link-license]: LICENSE\n\n[ico-version]: https://img.shields.io/packagist/v/zeeproject/date-range.svg?label=Latest\n[link-packagist]: https://packagist.org/packages/zeeproject/date-range\n\n[![Tests status][ico-tests-status]][link-github]\n[![Code Coverage][ico-scrutinizer]][link-scrutinizer]\n[![Quality Score][ico-code-quality]][link-code-quality]\n[![GitHub issues][ico-issues]][link-issues]\n[![Software License][ico-license]][link-license]\n[![Latest Version on Packagist][ico-version]][link-packagist]\n\nImplementation of the **Date Range** missing in PHP.\n\n## Install\n\nUsing [Composer](https://getcomposer.org)\n\n```bash\ncomposer require zeeproject/date-range\n```\n\n## Usage\n\n### DateRange - value object\n\nInstantiating value object and accessing properties:\n\n~~~php\n$range = new DateRange(new DateTime('-1 day'), new DateTime('+1 day'));\n// Checking if range has start date\n$range-\u003ehasStartDate();\n// Accessing range start date\n$range-\u003egetStartDate()-\u003eformat('c');\n// Checking if range has end date\n$range-\u003ehasEndDate();\n// Accessing range end date\n$range-\u003egetEndDate()-\u003eformat('c');\n// Checking if range is finite\n$range-\u003eisFinite();\n// Checking if range already started\n$range-\u003eisStarted();\n// Checking if range already ended\n$range-\u003eisEnded();\n// Checking if range started on specific date\n$range-\u003eisStartedOn(new DateTime());\n// Checking if range ended on specific date\n$range-\u003eisEndedOn(new DateTime());\n// Accessing range duration in seconds\n$range-\u003egetTimestampInterval();\n// Accessing range interval\n$range-\u003egetDateInterval()-\u003eformat('%s');\n// Printing\necho $range;\n// Representing as JSON\njson_encode($range);\n~~~\n\nIterating over the range:\n\n~~~php\n$range = new DateRange(new DateTime('-1 day'), new DateTime('+1 day'));\n\nforeach ($range-\u003egetDatePeriod(new DateInterval('P1D')) as $date) {\n    echo $date-\u003eformat('Y-m-d');\n}\n~~~\n\nSplitting range into smaller ranges:\n\n~~~php\n$range = new DateRange(new DateTime('-1 day'), new DateTime('+1 day'));\n\nforeach ($range-\u003esplit(new DateInterval('P1D')) as $range) {\n    echo $range;\n}\n~~~\n\nDate range is immutable, any changes resulting to new object:\n\n~~~php\n$initial = new DateRange(new DateTime('-1 day'), new DateTime('+1 day'));\n$actual = $initial-\u003esetStartDate(new DateTime('now'));\nif ($initial === $actual) {\n    throw new LogicException('Oh, ah');\n}\n~~~\n\n### DateRangeProvider - the date ranges builder.\n\nUsing builder to create new range with specific rules:\n\n~~~php\nclass RangeForYear implements DateRangeProvider\n{\n    /**\n     * @var int\n     */\n    private $year;\n\n    /**\n     * @param int $year\n     */\n    public function __construct(int $year)\n    {\n        $this-\u003eyear = $year;\n    }\n\n    public function getDateRange(): DateRangeInterface\n    {\n        return new DateRange(\n            new DateTimeImmutable(DateTimeImmutable::createFromFormat('c', \"{$this-\u003eyear}-01-01T00:00:00Z\")),\n            new DateTimeImmutable(DateTimeImmutable::createFromFormat('c', \"{$this-\u003eyear}-12-31T23:59:59Z\"))\n        );\n    }\n}\n~~~\n\nYour classes might depend on range provider instead of `DateRange`,\nuseful when predefined ranges are more meaningful than range interface:\n\n~~~php\nclass ReportCalculator\n{\n    public function calculate(DateRangeProvider $provider)\n    {\n        echo $provider-\u003egetDateRange();\n    }\n}\n\n$calculator-\u003ecalculate(new RangeForYear(2017));\n$calculator-\u003ecalculate(new RangeForQuarter(2017));\n$calculator-\u003ecalculate(new RangeForMonth(2017));\n~~~\n\nEven your class might require concrete range contract:\n\n~~~php\nclass ReportCalculator\n{\n    public function calculate(FiniteDateRangeProvider $provider)\n    {\n        echo $provider-\u003egetDateRange();\n    }\n}\n~~~\n\n## Testing\n\n```bash\nphpunit\n```\n\n## Contributing\n\nPlease see [CONTRIBUTING](.github/CONTRIBUTING.md) and [CODE OF CONDUCT](.github/CODE_OF_CONDUCT.md) for more details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslavcodev%2Fdate-range","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslavcodev%2Fdate-range","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslavcodev%2Fdate-range/lists"}