Search by 
sdui / daterange
This package is abandoned and no longer maintained.
No replacement package was suggested.
Provides an Object that contains the DateTimeRange for start and end times. Also provides the opportunity to create the gaps between a scope and multiple intersections.
0.1.2
2021-11-03 13:35 UTC
Requires
- php: >= 7.2
Requires (Dev)
- nesbot/carbon: ^2.54
- phpunit/phpunit: ^9.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
usage
Initializing
$beginsAt = new DateTime();
$endsAt = new DateTime();
$dateRange = new DateRange($beginsAt, $endsAt);
It may also be initialized with Carbon objects
new DateRange(Carbon::yesterday(), Carbon::now())
or from laravels helper functions
new DateRange(today(), now())
Gaps
It is possible to find gaps between a scope range and intersection ranges
/*
* Scope |0--------------------------24>
* Intersection
* Gaps {0 24}
*/
$start = Carbon::make('2021-11-25')->startOfDay();
$end = $start->clone()->endOfDay();
$scope = new DateRange($start, $end);
$gaps = DateRange::gaps($scope, []);
count($gaps); // 1
$gaps[0]->getStart(); // 2021-11-25 00:00:00
$gaps[0]->getEnd(); // 2021-11-25 23:59:59
More advanced
/*
* Scope |0--------------------------24>
* Intersection [0 9]
* Gaps {9 24}
*/
$start = Carbon::make('2021-11-25')->startOfDay();
$end = $start->clone()->endOfDay();
$scope = new DateRange($start, $end);
$intersection = new DateRange($start->clone(), $start->clone()->setHour(9));
$gaps = DateRange::gaps($scope, [$intersection]);
count($gaps); // 1
$gaps[0]->getStart(); // 2021-11-25 00:00:00
$gaps[0]->getEnd(); // 2021-11-25 08:59:59