SDUI/daterange

提供一个包含起始时间和结束时间的DateTimeRange对象。还提供了创建范围和多个交集之间间隙的机会。

维护者

详细信息

github.com/Sdui-GmbH/daterange

源代码

问题

安装: 4

依赖关系: 0

建议者: 0

安全: 0

星级: 4

关注者: 3

分支: 0

开放问题: 0

0.1.2 2021-11-03 13:35 UTC

Requires

  • php: >= 7.2

Requires (Dev)

MIT 5ca58ecad49e473e7b09c104320d885e126e9177

  • Sören Sauerbrei <soeren.sauerbrei.woop@sdui.de>
  • Jan Micha Kroll <kroll.woop@sdui.de>
  • Matthias Schermuly <matthias.schermuly.woop@sdui.de>

This package is auto-updated.

Last update: 2024-09-29 05:50:05 UTC

README

使用

初始化

$beginsAt = new DateTime();
$endsAt = new DateTime();
$dateRange = new DateRange($beginsAt, $endsAt);

也可以使用Carbon对象初始化

new DateRange(Carbon::yesterday(), Carbon::now())

或从laravels辅助函数中初始化

new DateRange(today(), now())

间隙

可以找到范围范围和交集范围之间的间隙

/*
 * 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

更高级

/*
 * 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