PHPackages gtmassey/quarter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. gtmassey/quarter ActiveLibrary[Utility & Helpers](/categories/utility) gtmassey/quarter ================ Easily retrieve start and end dates for calendar quarters or fiscal quarters for any year. An extension of gtmassey/period v2.1.2(1y ago)0532MITPHPPHP ^8.1|^8.2|^8.3CI passing Since Aug 2Pushed 1y ago1 watchersCompare [ Source](https://github.com/gtmassey/quarter)[ Packagist](https://packagist.org/packages/gtmassey/quarter)[ Docs](https://github.com/gtmassey/quarter)[ RSS](/packages/gtmassey-quarter/feed)WikiDiscussions main Synced yesterday READMEChangelog (6)Dependencies (12)Versions (10)Used By (0) Quarter ======= [](#quarter) [![Latest Version on Packagist](https://camo.githubusercontent.com/f14248d32bafce7586dcc01e86040d1c1478a7dc0fc870fb74f3da2f211c78cf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67746d61737365792f717561727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gtmassey/quarter)[![Total Downloads](https://camo.githubusercontent.com/8837f74a0cfac1026381a832c5fa648aa2939d0dcd75aa4954dbb27997679a6f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67746d61737365792f717561727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/gtmassey/quarter)[![Tests](https://github.com/gtmassey/quarter/actions/workflows/run-tests.yml/badge.svg)](https://github.com/gtmassey/quarter/actions/workflows/run-tests.yml) Retrieve start and end dates for calendar or fiscal quarters for any year with ease! Installation ------------ [](#installation) You can install the package via composer: ``` composer require gtmassey/quarter ``` This package is an extension of the gtmassey/period package. You can find the documentation for that package [here](https://github.com/gtmassey/period). Usage ----- [](#usage) The package provides a `Quarter` class which contains static methods for each quarter of a year, and additional methods that can be chained on that allow for mutations of the quarter to specific years, calendar types, and dates. ``` //Jan 1, YYYY - Mar 31, YYYY Quarter::first(); //Apr 1, YYYY - Jun 30, YYYY Quarter::second(); //Jul 1, YYYY - Sep 30, YYYY Quarter::third(); //Oct 1, YYYY - Dec 31, YYYY Quarter::fourth(); ``` As an extension of the `Period` class from [gtmassey/period](https://github.com/gtmassey/period), the resulting Quarter object is structured the same way: ``` Gtmassey\Quarter\Quarter {#6221 +startDate: Carbon\CarbonImmutable @1672531200 {#6224 date: 2023-01-01 00:00:00.0 UTC (+00:00), }, +endDate: Carbon\CarbonImmutable @1680307199 {#6220 date: 2023-03-31 23:59:59.999999 UTC (+00:00), }, } ``` ### Specifying Years [](#specifying-years) If you want to specify the year of the quarter, you can chain the `year()` method on the quarter. Note that you have to format the year as `YYYY`. If you don't, it will take the year literally, i.e. the year 0020. ``` //Jan 1, 2020 - Mar 31, 2020 Quarter::first()->year(2020); //Jan 1, 0020 - Mar 31, 0020 Quarter::first()->year(20); //Jan 1, 1995 - Mar 31, 1995 Quarter::first()->year(1995); ``` ### Changing the Resulting Object [](#changing-the-resulting-object) By default, the `Quarter` class returns a `Quarter` object. You can default to the parent `Period` object by calling the `asPeriod()` method: ``` Quarter::first()->asPeriod(); ``` which will result in an instance of Period like so: ``` Gtmassey\Period\Period { +startDate: Carbon\CarbonImmutable @1672531200 { date: 2023-01-01 00:00:00.0 UTC (+00:00), }, +endDate: Carbon\CarbonImmutable @1680307199 { date: 2023-03-31 23:59:59.999999 UTC (+00:00), }, } ``` ### Changing Calendar Types [](#changing-calendar-types) So far, the quarter methods have been assuming a calendar year for the quarter dates. If you want to use the fiscal year in which the first quarter starts on July 1, you can chain the `toFiscal()` method: ``` //July 1, YYYY - September 30, YYYY Quarter::first()->toFiscal(); ``` Please note that when using the `toFiscal` method, the resulting object assumes that the *current year* is the start of the fiscal year. That is, if the current year is 2022, but you are in the fiscal year FY21 (which starts on July 1, 2021, and ends on June 30, 2022), the `Quarter::first()->toFiscal()` will return a date of `July 1, 2022` instead of `July 1, 2021`, because it assumes the current year is the start of the fiscal year. To avoid this behavior, you can use the helper method `getCurrentFiscalYear()` or `currentFiscalYear()` and pass that into the `year()` method like so: ``` // example, say today's date is May 1, 2022. // this means that we are in Q2 of the calendar year 2022 // but in Q4 of Fiscal Year 2021 // to get the first quarter of the current fiscal year, you can do this: //July 1, 2021 - September 30, 2021 Quarter::first()->year(Quarter::getCurrentFiscalYear())->toFiscal(); ``` You can chain the `year()` and `toFiscal()` methods together: ``` //July 1, 1995 - September 30, 1995 Quarter::first()->year(1995)->toFiscal(); ``` and if you want the resulting object to be an instance of the parent `Period` class, you can chain the `asPeriod()` method: ``` //July 1, 1995 - September 30, 1995 Quarter::first()->year(1995)->toFiscal()->asPeriod(); ``` The `toFiscal()` method creates a new `Quarter` instance that is 6 months ahead of the current `Quarter`. ``` //Jan 1, YYYY - Mar 31, YYYY Quarter::first(); //Jul 1, YYYY - Sep 30, YYY Quarter::first()->toFiscal(); ``` If you wish to convert the current `Quarter` instance into a fiscal representation, you can use the `asFiscal()` method. The difference between `toFiscal()` and `asFiscal()` is that the `asFiscal()` keeps the start and end dates the same, it just changes the instance's name to be the correct representation in a fiscal calendar. ``` //Jul 1, YYYY - Sep 30, YYYY //Q3 Quarter::third(); //Jul 1, YYYY - Sep 30, YYYY //Q1 Quarter::first()->toFiscal(); ``` Using the `asFiscal()` method preserves the start and end dates of the quarter, but changes the `name` and `isFiscal` properties on the object. ### Start and End Dates Only [](#start-and-end-dates-only) Sometimes you only need to access the start and end dates of a given quarter, without accessing the entire range. To do that, simply add the `startDate()` or `endDate()` method to the chain: ``` //July 1, 2020 Quarter::third()->year(20)->startDate(); ``` ### Past and Future Quarters: [](#past-and-future-quarters) If you have a given quarter object, and you want to get the next quarter, you can use the `next()` method: ``` $quarter = Quarter::first()->year(2020); //Jan 1, 2020 - Mar 31, 2020 $next = $quarter->next(); //Apr 1, 2020 - Jun 30, 2020 ``` To get the previous quarters from a given Quarter object, use the `previous()` method: ``` $quarter = Quarter::first()->year(2020); //Jan 1, 2020 - Mar 31, 2020 $previous = $quarter->previous(); //Oct 1, 2019 - Dec 31, 2019 ``` Finally, you can access the current quarter by calling the `current()` method: ``` $current = Quarter::current(); //return the dates for the current quarter, regardless of calendar or fiscal dates. ``` ### Laravel Note: [](#laravel-note) The parent `Period` class is written specifically for Laravel because it is an extracted package from the [gtmassey/laravel-analytics](https://github.com/gtmassey/laravel-analytics) package. However, the Quarter class does not need Laravel to function. If you want to use the `Quarter` class in Laravel, you can add the class to your `config/app.php` aliases array: ``` 'aliases' => Facade::defaultAliases()->merge([ // 'Example' => App\Facades\Example::class, 'Quarter' => Gtmassey\Quarter\Quarter::class, ])->toArray(), ``` Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) To contribute, fork the repo, create a new branch, and submit a pull request. I will do my best to review them in a timely manner. License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 37 — LowBetter than 81% of packages Maintenance47 Moderate activity, may be stable Popularity14 Limited adoption so far Community7 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~133 days Recently: every ~166 days Total 6 Last Release 400d ago Major Versions v1.1 → v2.0.02024-11-13 PHP version history (3 changes)v1.0PHP ^8.1 v1.1PHP ^8.1||^8.2 v2.1.0PHP ^8.1|^8.2|^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/f198e204b73532fa68ddd5c60c226cbc25eb9113cfac0bea19337434e944e2d4?d=identicon)[gtmassey](/maintainers/gtmassey) --- Top Contributors [![gtmassey](https://avatars.githubusercontent.com/u/109831143?v=4)](https://github.com/gtmassey "gtmassey (42 commits)") --- Tags periodgtmasseyquarter ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/gtmassey-quarter/health.svg) ``` [![Health](https://phpackages.com/badges/gtmassey-quarter/health.svg)](https://phpackages.com/packages/gtmassey-quarter) ``` ### Alternatives [illuminate/support The Illuminate Support package. 630113.0M41.3k](/packages/illuminate-support)[spatie/holidays Calculate public holidays 402860.1k2](/packages/spatie-holidays)[craftcms/feed-me Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more. 293952.6k33](/packages/craftcms-feed-me)[solspace/craft-freeform The most flexible and user-friendly form building plugin! 54681.3k18](/packages/solspace-craft-freeform)[pimcore/data-importer Adds a comprehensive import functionality to Pimcore Datahub 46855.5k5](/packages/pimcore-data-importer)[japanese-date/japanese-date 日本の暦、祝日を取り扱うライブラリ 1610.0k](/packages/japanese-date-japanese-date) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)