Файл: vendor/nesbot/carbon/src/Carbon/Traits/IntervalStep.php
Строк: 130
<?php
declare(strict_types=1);
/**
* This file is part of the Carbon package.
*
* (c) Brian Nesbitt <brian@nesbot.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace CarbonTraits;
use BadMethodCallException;
use CarbonCallback;
use CarbonCarbon;
use CarbonCarbonImmutable;
use CarbonCarbonInterface;
use Closure;
use DateTimeImmutable;
use DateTimeInterface;
trait IntervalStep
{
/**
* Step to apply instead of a fixed interval to get the new date.
*
* @var Closure|null
*/
protected ?Closure $step = null;
/**
* Get the dynamic step in use.
*
* @return Closure|null
*/
public function getStep(): ?Closure
{
return $this->step;
}
/**
* Set a step to apply instead of a fixed interval to get the new date.
*
* Or pass null to switch to fixed interval.
*
* @param Closure|null $step
*/
public function setStep(?Closure $step): void
{
$this->step = $step;
}
/**
* Take a date and apply either the step if set, or the current interval else.
*
* The interval/step is applied negatively (typically subtraction instead of addition) if $negated is true.
*
* @param DateTimeInterface $dateTime
* @param bool $negated
*
* @return CarbonInterface
*/
public function convertDate(DateTimeInterface $dateTime, bool $negated = false): CarbonInterface
{
$carbonDate = $this->carbonOrResolve($dateTime);
if ($this->step) {
$carbonDate = Callback::parameter($this->step, $carbonDate->avoidMutation());
return $carbonDate->modify(($this->step)($carbonDate, $negated)->format('Y-m-d H:i:s.u e O'));
}
if ($negated) {
return $carbonDate->rawSub($this);
}
return $carbonDate->rawAdd($this);
}
/**
* Convert DateTimeImmutable instance to CarbonImmutable instance and DateTime instance to Carbon instance.
*/
private function resolveCarbon(DateTimeInterface $dateTime): Carbon|CarbonImmutable
{
if ($dateTime instanceof DateTimeImmutable) {
return CarbonImmutable::instance($dateTime);
}
return Carbon::instance($dateTime);
}
private function carbonOrResolve(mixed $dateTime): CarbonInterface
{
return $dateTime instanceof CarbonInterface
? $dateTime
: $this->resolveCarbon($dateTime);
}
private function checkNoStepIsDefined(string $method): void
{
if ($this->step !== null) {
$chunks = explode('::', $method, 2);
$method = $chunks[1] ?? $method;
throw new BadMethodCallException(
"->$method() cannot be called on an interval with a step",
);
}
}
}