Dolibarr / dolibarr

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Doctrine/CarbonImmutableType.php

Indentation +18 added lines, -18 removed lines

@@ -15,23 +15,23 @@
 
 class CarbonImmutableType extends DateTimeImmutableType implements CarbonDoctrineType
 {
-    /**
-     * {@inheritdoc}
-     *
-     * @return string
-     */
-    public function getName()
-    {
-        return 'carbon_immutable';
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return string
+	 */
+	public function getName()
+	{
+		return 'carbon_immutable';
+	}
 
-    /**
-     * {@inheritdoc}
-     *
-     * @return bool
-     */
-    public function requiresSQLCommentHint(AbstractPlatform $platform)
-    {
-        return true;
-    }
+	/**
+	 * {@inheritdoc}
+	 *
+	 * @return bool
+	 */
+	public function requiresSQLCommentHint(AbstractPlatform $platform)
+	{
+		return true;
+	}
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Factory.php

Indentation +64 added lines, -64 removed lines

@@ -241,86 +241,86 @@
  */
 class Factory
 {
-    protected $className = Carbon::class;
+	protected $className = Carbon::class;
 
-    protected $settings = [];
+	protected $settings = [];
 
-    public function __construct(array $settings = [], ?string $className = null)
-    {
-        if ($className) {
-            $this->className = $className;
-        }
+	public function __construct(array $settings = [], ?string $className = null)
+	{
+		if ($className) {
+			$this->className = $className;
+		}
 
-        $this->settings = $settings;
-    }
+		$this->settings = $settings;
+	}
 
-    public function getClassName()
-    {
-        return $this->className;
-    }
+	public function getClassName()
+	{
+		return $this->className;
+	}
 
-    public function setClassName(string $className)
-    {
-        $this->className = $className;
+	public function setClassName(string $className)
+	{
+		$this->className = $className;
 
-        return $this;
-    }
+		return $this;
+	}
 
-    public function className(string $className = null)
-    {
-        return $className === null ? $this->getClassName() : $this->setClassName($className);
-    }
+	public function className(string $className = null)
+	{
+		return $className === null ? $this->getClassName() : $this->setClassName($className);
+	}
 
-    public function getSettings()
-    {
-        return $this->settings;
-    }
+	public function getSettings()
+	{
+		return $this->settings;
+	}
 
-    public function setSettings(array $settings)
-    {
-        $this->settings = $settings;
+	public function setSettings(array $settings)
+	{
+		$this->settings = $settings;
 
-        return $this;
-    }
+		return $this;
+	}
 
-    public function settings(array $settings = null)
-    {
-        return $settings === null ? $this->getSettings() : $this->setSettings($settings);
-    }
+	public function settings(array $settings = null)
+	{
+		return $settings === null ? $this->getSettings() : $this->setSettings($settings);
+	}
 
-    public function mergeSettings(array $settings)
-    {
-        $this->settings = array_merge($this->settings, $settings);
+	public function mergeSettings(array $settings)
+	{
+		$this->settings = array_merge($this->settings, $settings);
 
-        return $this;
-    }
+		return $this;
+	}
 
-    public function __call($name, $arguments)
-    {
-        $method = new ReflectionMethod($this->className, $name);
-        $settings = $this->settings;
+	public function __call($name, $arguments)
+	{
+		$method = new ReflectionMethod($this->className, $name);
+		$settings = $this->settings;
 
-        if ($settings && isset($settings['timezone'])) {
-            $tzParameters = array_filter($method->getParameters(), function ($parameter) {
-                return \in_array($parameter->getName(), ['tz', 'timezone'], true);
-            });
+		if ($settings && isset($settings['timezone'])) {
+			$tzParameters = array_filter($method->getParameters(), function ($parameter) {
+				return \in_array($parameter->getName(), ['tz', 'timezone'], true);
+			});
 
-            if (isset($arguments[0]) && \in_array($name, ['instance', 'make', 'create', 'parse'], true)) {
-                if ($arguments[0] instanceof DateTimeInterface) {
-                    $settings['innerTimezone'] = $settings['timezone'];
-                } elseif (\is_string($arguments[0]) && date_parse($arguments[0])['is_localtime']) {
-                    unset($settings['timezone'], $settings['innerTimezone']);
-                }
-            } elseif (\count($tzParameters)) {
-                array_splice($arguments, key($tzParameters), 0, [$settings['timezone']]);
-                unset($settings['timezone']);
-            }
-        }
+			if (isset($arguments[0]) && \in_array($name, ['instance', 'make', 'create', 'parse'], true)) {
+				if ($arguments[0] instanceof DateTimeInterface) {
+					$settings['innerTimezone'] = $settings['timezone'];
+				} elseif (\is_string($arguments[0]) && date_parse($arguments[0])['is_localtime']) {
+					unset($settings['timezone'], $settings['innerTimezone']);
+				}
+			} elseif (\count($tzParameters)) {
+				array_splice($arguments, key($tzParameters), 0, [$settings['timezone']]);
+				unset($settings['timezone']);
+			}
+		}
 
-        $result = $this->className::$name(...$arguments);
+		$result = $this->className::$name(...$arguments);
 
-        return $result instanceof CarbonInterface && !empty($settings)
-            ? $result->settings($settings)
-            : $result;
-    }
+		return $result instanceof CarbonInterface && !empty($settings)
+			? $result->settings($settings)
+			: $result;
+	}
 }

Spacing +1 added lines, -1 removed lines

@@ -301,7 +301,7 @@
         $settings = $this->settings;
 
         if ($settings && isset($settings['timezone'])) {
-            $tzParameters = array_filter($method->getParameters(), function ($parameter) {
+            $tzParameters = array_filter($method->getParameters(), function($parameter) {
                 return \in_array($parameter->getName(), ['tz', 'timezone'], true);
             });
 

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Cli/Invoker.php

Indentation +16 added lines, -16 removed lines

@@ -13,26 +13,26 @@
 
 class Invoker
 {
-    public const CLI_CLASS_NAME = 'Carbon\\Cli';
+	public const CLI_CLASS_NAME = 'Carbon\\Cli';
 
-    protected function runWithCli(string $className, array $parameters): bool
-    {
-        $cli = new $className();
+	protected function runWithCli(string $className, array $parameters): bool
+	{
+		$cli = new $className();
 
-        return $cli(...$parameters);
-    }
+		return $cli(...$parameters);
+	}
 
-    public function __invoke(...$parameters): bool
-    {
-        if (class_exists(self::CLI_CLASS_NAME)) {
-            return $this->runWithCli(self::CLI_CLASS_NAME, $parameters);
-        }
+	public function __invoke(...$parameters): bool
+	{
+		if (class_exists(self::CLI_CLASS_NAME)) {
+			return $this->runWithCli(self::CLI_CLASS_NAME, $parameters);
+		}
 
-        $function = (($parameters[1] ?? '') === 'install' ? ($parameters[2] ?? null) : null) ?: 'shell_exec';
-        $function('composer require carbon-cli/carbon-cli --no-interaction');
+		$function = (($parameters[1] ?? '') === 'install' ? ($parameters[2] ?? null) : null) ?: 'shell_exec';
+		$function('composer require carbon-cli/carbon-cli --no-interaction');
 
-        echo 'Installation succeeded.';
+		echo 'Installation succeeded.';
 
-        return true;
-    }
+		return true;
+	}
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/TranslatorStrongTypeInterface.php

Indentation +1 added lines, -1 removed lines

@@ -18,5 +18,5 @@
  */
 interface TranslatorStrongTypeInterface
 {
-    public function getFromCatalogue(MessageCatalogueInterface $catalogue, string $id, string $domain = 'messages');
+	public function getFromCatalogue(MessageCatalogueInterface $catalogue, string $id, string $domain = 'messages');
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/CarbonPeriod.php

Indentation +2470 added lines, -2470 removed lines

@@ -170,2474 +170,2474 @@
  */
 class CarbonPeriod implements Iterator, Countable, JsonSerializable
 {
-    use IntervalRounding;
-    use Mixin {
-        Mixin::mixin as baseMixin;
-    }
-    use Options;
-
-    /**
-     * Built-in filter for limit by recurrences.
-     *
-     * @var callable
-     */
-    public const RECURRENCES_FILTER = [self::class, 'filterRecurrences'];
-
-    /**
-     * Built-in filter for limit to an end.
-     *
-     * @var callable
-     */
-    public const END_DATE_FILTER = [self::class, 'filterEndDate'];
-
-    /**
-     * Special value which can be returned by filters to end iteration. Also a filter.
-     *
-     * @var callable
-     */
-    public const END_ITERATION = [self::class, 'endIteration'];
-
-    /**
-     * Exclude start date from iteration.
-     *
-     * @var int
-     */
-    public const EXCLUDE_START_DATE = 1;
-
-    /**
-     * Exclude end date from iteration.
-     *
-     * @var int
-     */
-    public const EXCLUDE_END_DATE = 2;
-
-    /**
-     * Yield CarbonImmutable instances.
-     *
-     * @var int
-     */
-    public const IMMUTABLE = 4;
-
-    /**
-     * Number of maximum attempts before giving up on finding next valid date.
-     *
-     * @var int
-     */
-    public const NEXT_MAX_ATTEMPTS = 1000;
-
-    /**
-     * Number of maximum attempts before giving up on finding end date.
-     *
-     * @var int
-     */
-    public const END_MAX_ATTEMPTS = 10000;
-
-    /**
-     * The registered macros.
-     *
-     * @var array
-     */
-    protected static $macros = [];
-
-    /**
-     * Date class of iteration items.
-     *
-     * @var string
-     */
-    protected $dateClass = Carbon::class;
-
-    /**
-     * Underlying date interval instance. Always present, one day by default.
-     *
-     * @var CarbonInterval
-     */
-    protected $dateInterval;
-
-    /**
-     * Whether current date interval was set by default.
-     *
-     * @var bool
-     */
-    protected $isDefaultInterval;
-
-    /**
-     * The filters stack.
-     *
-     * @var array
-     */
-    protected $filters = [];
-
-    /**
-     * Period start date. Applied on rewind. Always present, now by default.
-     *
-     * @var CarbonInterface
-     */
-    protected $startDate;
-
-    /**
-     * Period end date. For inverted interval should be before the start date. Applied via a filter.
-     *
-     * @var CarbonInterface|null
-     */
-    protected $endDate;
-
-    /**
-     * Limit for number of recurrences. Applied via a filter.
-     *
-     * @var int|null
-     */
-    protected $recurrences;
-
-    /**
-     * Iteration options.
-     *
-     * @var int
-     */
-    protected $options;
-
-    /**
-     * Index of current date. Always sequential, even if some dates are skipped by filters.
-     * Equal to null only before the first iteration.
-     *
-     * @var int
-     */
-    protected $key;
-
-    /**
-     * Current date. May temporarily hold unaccepted value when looking for a next valid date.
-     * Equal to null only before the first iteration.
-     *
-     * @var CarbonInterface
-     */
-    protected $current;
-
-    /**
-     * Timezone of current date. Taken from the start date.
-     *
-     * @var \DateTimeZone|null
-     */
-    protected $timezone;
-
-    /**
-     * The cached validation result for current date.
-     *
-     * @var bool|string|null
-     */
-    protected $validationResult;
-
-    /**
-     * Timezone handler for settings() method.
-     *
-     * @var mixed
-     */
-    protected $tzName;
-
-    /**
-     * Make a CarbonPeriod instance from given variable if possible.
-     *
-     * @param mixed $var
-     *
-     * @return static|null
-     */
-    public static function make($var)
-    {
-        try {
-            return static::instance($var);
-        } catch (NotAPeriodException $e) {
-            return static::create($var);
-        }
-    }
-
-    /**
-     * Create a new instance from a DatePeriod or CarbonPeriod object.
-     *
-     * @param CarbonPeriod|DatePeriod $period
-     *
-     * @return static
-     */
-    public static function instance($period)
-    {
-        if ($period instanceof static) {
-            return $period->copy();
-        }
-
-        if ($period instanceof self) {
-            return new static(
-                $period->getStartDate(),
-                $period->getEndDate() ?: $period->getRecurrences(),
-                $period->getDateInterval(),
-                $period->getOptions()
-            );
-        }
-
-        if ($period instanceof DatePeriod) {
-            return new static(
-                $period->start,
-                $period->end ?: ($period->recurrences - 1),
-                $period->interval,
-                $period->include_start_date ? 0 : static::EXCLUDE_START_DATE
-            );
-        }
-
-        $class = static::class;
-        $type = \gettype($period);
-
-        throw new NotAPeriodException(
-            'Argument 1 passed to '.$class.'::'.__METHOD__.'() '.
-            'must be an instance of DatePeriod or '.$class.', '.
-            ($type === 'object' ? 'instance of '.\get_class($period) : $type).' given.'
-        );
-    }
-
-    /**
-     * Create a new instance.
-     *
-     * @return static
-     */
-    public static function create(...$params)
-    {
-        return static::createFromArray($params);
-    }
-
-    /**
-     * Create a new instance from an array of parameters.
-     *
-     * @param array $params
-     *
-     * @return static
-     */
-    public static function createFromArray(array $params)
-    {
-        return new static(...$params);
-    }
-
-    /**
-     * Create CarbonPeriod from ISO 8601 string.
-     *
-     * @param string   $iso
-     * @param int|null $options
-     *
-     * @return static
-     */
-    public static function createFromIso($iso, $options = null)
-    {
-        $params = static::parseIso8601($iso);
-
-        $instance = static::createFromArray($params);
-
-        if ($options !== null) {
-            $instance->setOptions($options);
-        }
-
-        return $instance;
-    }
-
-    /**
-     * Return whether given interval contains non zero value of any time unit.
-     *
-     * @param \DateInterval $interval
-     *
-     * @return bool
-     */
-    protected static function intervalHasTime(DateInterval $interval)
-    {
-        return $interval->h || $interval->i || $interval->s || $interval->f;
-    }
-
-    /**
-     * Return whether given variable is an ISO 8601 specification.
-     *
-     * Note: Check is very basic, as actual validation will be done later when parsing.
-     * We just want to ensure that variable is not any other type of a valid parameter.
-     *
-     * @param mixed $var
-     *
-     * @return bool
-     */
-    protected static function isIso8601($var)
-    {
-        if (!\is_string($var)) {
-            return false;
-        }
-
-        // Match slash but not within a timezone name.
-        $part = '[a-z]+(?:[_-][a-z]+)*';
-
-        preg_match("#\b$part/$part\b|(/)#i", $var, $match);
-
-        return isset($match[1]);
-    }
-
-    /**
-     * Parse given ISO 8601 string into an array of arguments.
-     *
-     * @SuppressWarnings(PHPMD.ElseExpression)
-     *
-     * @param string $iso
-     *
-     * @return array
-     */
-    protected static function parseIso8601($iso)
-    {
-        $result = [];
-
-        $interval = null;
-        $start = null;
-        $end = null;
-
-        foreach (explode('/', $iso) as $key => $part) {
-            if ($key === 0 && preg_match('/^R(\d*|INF)$/', $part, $match)) {
-                $parsed = \strlen($match[1]) ? (($match[1] !== 'INF') ? (int) $match[1] : INF) : null;
-            } elseif ($interval === null && $parsed = CarbonInterval::make($part)) {
-                $interval = $part;
-            } elseif ($start === null && $parsed = Carbon::make($part)) {
-                $start = $part;
-            } elseif ($end === null && $parsed = Carbon::make(static::addMissingParts($start ?? '', $part))) {
-                $end = $part;
-            } else {
-                throw new InvalidPeriodParameterException("Invalid ISO 8601 specification: $iso.");
-            }
-
-            $result[] = $parsed;
-        }
-
-        return $result;
-    }
-
-    /**
-     * Add missing parts of the target date from the soure date.
-     *
-     * @param string $source
-     * @param string $target
-     *
-     * @return string
-     */
-    protected static function addMissingParts($source, $target)
-    {
-        $pattern = '/'.preg_replace('/\d+/', '[0-9]+', preg_quote($target, '/')).'$/';
-
-        $result = preg_replace($pattern, $target, $source, 1, $count);
-
-        return $count ? $result : $target;
-    }
-
-    /**
-     * Register a custom macro.
-     *
-     * @example
-     * ```
-     * CarbonPeriod::macro('middle', function () {
-     *   return $this->getStartDate()->average($this->getEndDate());
-     * });
-     * echo CarbonPeriod::since('2011-05-12')->until('2011-06-03')->middle();
-     * ```
-     *
-     * @param string          $name
-     * @param object|callable $macro
-     *
-     * @return void
-     */
-    public static function macro($name, $macro)
-    {
-        static::$macros[$name] = $macro;
-    }
-
-    /**
-     * Register macros from a mixin object.
-     *
-     * @example
-     * ```
-     * CarbonPeriod::mixin(new class {
-     *   public function addDays() {
-     *     return function ($count = 1) {
-     *       return $this->setStartDate(
-     *         $this->getStartDate()->addDays($count)
-     *       )->setEndDate(
-     *         $this->getEndDate()->addDays($count)
-     *       );
-     *     };
-     *   }
-     *   public function subDays() {
-     *     return function ($count = 1) {
-     *       return $this->setStartDate(
-     *         $this->getStartDate()->subDays($count)
-     *       )->setEndDate(
-     *         $this->getEndDate()->subDays($count)
-     *       );
-     *     };
-     *   }
-     * });
-     * echo CarbonPeriod::create('2000-01-01', '2000-02-01')->addDays(5)->subDays(3);
-     * ```
-     *
-     * @param object|string $mixin
-     *
-     * @throws ReflectionException
-     *
-     * @return void
-     */
-    public static function mixin($mixin)
-    {
-        static::baseMixin($mixin);
-    }
-
-    /**
-     * Check if macro is registered.
-     *
-     * @param string $name
-     *
-     * @return bool
-     */
-    public static function hasMacro($name)
-    {
-        return isset(static::$macros[$name]);
-    }
-
-    /**
-     * Provide static proxy for instance aliases.
-     *
-     * @param string $method
-     * @param array  $parameters
-     *
-     * @return mixed
-     */
-    public static function __callStatic($method, $parameters)
-    {
-        $date = new static();
-
-        if (static::hasMacro($method)) {
-            return static::bindMacroContext(null, function () use (&$method, &$parameters, &$date) {
-                return $date->callMacro($method, $parameters);
-            });
-        }
-
-        return $date->$method(...$parameters);
-    }
-
-    /**
-     * CarbonPeriod constructor.
-     *
-     * @SuppressWarnings(PHPMD.ElseExpression)
-     *
-     * @throws InvalidArgumentException
-     */
-    public function __construct(...$arguments)
-    {
-        // Parse and assign arguments one by one. First argument may be an ISO 8601 spec,
-        // which will be first parsed into parts and then processed the same way.
-
-        $argumentsCount = \count($arguments);
-
-        if ($argumentsCount && static::isIso8601($iso = $arguments[0])) {
-            array_splice($arguments, 0, 1, static::parseIso8601($iso));
-        }
-
-        if ($argumentsCount === 1) {
-            if ($arguments[0] instanceof DatePeriod) {
-                $arguments = [
-                    $arguments[0]->start,
-                    $arguments[0]->end ?: ($arguments[0]->recurrences - 1),
-                    $arguments[0]->interval,
-                    $arguments[0]->include_start_date ? 0 : static::EXCLUDE_START_DATE,
-                ];
-            } elseif ($arguments[0] instanceof self) {
-                $arguments = [
-                    $arguments[0]->getStartDate(),
-                    $arguments[0]->getEndDate() ?: $arguments[0]->getRecurrences(),
-                    $arguments[0]->getDateInterval(),
-                    $arguments[0]->getOptions(),
-                ];
-            }
-        }
-
-        foreach ($arguments as $argument) {
-            $parsedDate = null;
-
-            if ($argument instanceof DateTimeZone) {
-                $this->setTimezone($argument);
-            } elseif ($this->dateInterval === null &&
-                (
-                    (\is_string($argument) && preg_match(
-                        '/^(-?\d(\d(?![\/-])|[^\d\/-]([\/-])?)*|P[T\d].*|(?:\h*\d+(?:\.\d+)?\h*[a-z]+)+)$/i',
-                        $argument
-                    )) ||
-                    $argument instanceof DateInterval ||
-                    $argument instanceof Closure
-                ) &&
-                $parsedInterval = @CarbonInterval::make($argument)
-            ) {
-                $this->setDateInterval($parsedInterval);
-            } elseif ($this->startDate === null && $parsedDate = $this->makeDateTime($argument)) {
-                $this->setStartDate($parsedDate);
-            } elseif ($this->endDate === null && ($parsedDate = $parsedDate ?? $this->makeDateTime($argument))) {
-                $this->setEndDate($parsedDate);
-            } elseif ($this->recurrences === null && $this->endDate === null && is_numeric($argument)) {
-                $this->setRecurrences($argument);
-            } elseif ($this->options === null && (\is_int($argument) || $argument === null)) {
-                $this->setOptions($argument);
-            } else {
-                throw new InvalidPeriodParameterException('Invalid constructor parameters.');
-            }
-        }
-
-        if ($this->startDate === null) {
-            $this->setStartDate(Carbon::now());
-        }
-
-        if ($this->dateInterval === null) {
-            $this->setDateInterval(CarbonInterval::day());
-
-            $this->isDefaultInterval = true;
-        }
-
-        if ($this->options === null) {
-            $this->setOptions(0);
-        }
-    }
-
-    /**
-     * Get a copy of the instance.
-     *
-     * @return static
-     */
-    public function copy()
-    {
-        return clone $this;
-    }
-
-    /**
-     * Get the getter for a property allowing both `DatePeriod` snakeCase and camelCase names.
-     *
-     * @param string $name
-     *
-     * @return callable|null
-     */
-    protected function getGetter(string $name)
-    {
-        switch (strtolower(preg_replace('/[A-Z]/', '_$0', $name))) {
-            case 'start':
-            case 'start_date':
-                return [$this, 'getStartDate'];
-            case 'end':
-            case 'end_date':
-                return [$this, 'getEndDate'];
-            case 'interval':
-            case 'date_interval':
-                return [$this, 'getDateInterval'];
-            case 'recurrences':
-                return [$this, 'getRecurrences'];
-            case 'include_start_date':
-                return [$this, 'isStartIncluded'];
-            case 'include_end_date':
-                return [$this, 'isEndIncluded'];
-            case 'current':
-                return [$this, 'current'];
-            default:
-                return null;
-        }
-    }
-
-    /**
-     * Get a property allowing both `DatePeriod` snakeCase and camelCase names.
-     *
-     * @param string $name
-     *
-     * @return bool|CarbonInterface|CarbonInterval|int|null
-     */
-    public function get(string $name)
-    {
-        $getter = $this->getGetter($name);
-
-        if ($getter) {
-            return $getter();
-        }
-
-        throw new UnknownGetterException($name);
-    }
-
-    /**
-     * Get a property allowing both `DatePeriod` snakeCase and camelCase names.
-     *
-     * @param string $name
-     *
-     * @return bool|CarbonInterface|CarbonInterval|int|null
-     */
-    public function __get(string $name)
-    {
-        return $this->get($name);
-    }
-
-    /**
-     * Check if an attribute exists on the object
-     *
-     * @param string $name
-     *
-     * @return bool
-     */
-    public function __isset(string $name): bool
-    {
-        return $this->getGetter($name) !== null;
-    }
-
-    /**
-     * @alias copy
-     *
-     * Get a copy of the instance.
-     *
-     * @return static
-     */
-    public function clone()
-    {
-        return clone $this;
-    }
-
-    /**
-     * Set the iteration item class.
-     *
-     * @param string $dateClass
-     *
-     * @return $this
-     */
-    public function setDateClass(string $dateClass)
-    {
-        if (!is_a($dateClass, CarbonInterface::class, true)) {
-            throw new NotACarbonClassException($dateClass);
-        }
-
-        $this->dateClass = $dateClass;
-
-        if (is_a($dateClass, Carbon::class, true)) {
-            $this->toggleOptions(static::IMMUTABLE, false);
-        } elseif (is_a($dateClass, CarbonImmutable::class, true)) {
-            $this->toggleOptions(static::IMMUTABLE, true);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Returns iteration item date class.
-     *
-     * @return string
-     */
-    public function getDateClass(): string
-    {
-        return $this->dateClass;
-    }
-
-    /**
-     * Change the period date interval.
-     *
-     * @param DateInterval|string $interval
-     *
-     * @throws InvalidIntervalException
-     *
-     * @return $this
-     */
-    public function setDateInterval($interval)
-    {
-        if (!$interval = CarbonInterval::make($interval)) {
-            throw new InvalidIntervalException('Invalid interval.');
-        }
-
-        if ($interval->spec() === 'PT0S' && !$interval->f && !$interval->getStep()) {
-            throw new InvalidIntervalException('Empty interval is not accepted.');
-        }
-
-        $this->dateInterval = $interval;
-
-        $this->isDefaultInterval = false;
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Invert the period date interval.
-     *
-     * @return $this
-     */
-    public function invertDateInterval()
-    {
-        $interval = $this->dateInterval->invert();
-
-        return $this->setDateInterval($interval);
-    }
-
-    /**
-     * Set start and end date.
-     *
-     * @param DateTime|DateTimeInterface|string      $start
-     * @param DateTime|DateTimeInterface|string|null $end
-     *
-     * @return $this
-     */
-    public function setDates($start, $end)
-    {
-        $this->setStartDate($start);
-        $this->setEndDate($end);
-
-        return $this;
-    }
-
-    /**
-     * Change the period options.
-     *
-     * @param int|null $options
-     *
-     * @throws InvalidArgumentException
-     *
-     * @return $this
-     */
-    public function setOptions($options)
-    {
-        if (!\is_int($options) && $options !== null) {
-            throw new InvalidPeriodParameterException('Invalid options.');
-        }
-
-        $this->options = $options ?: 0;
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Get the period options.
-     *
-     * @return int
-     */
-    public function getOptions()
-    {
-        return $this->options;
-    }
-
-    /**
-     * Toggle given options on or off.
-     *
-     * @param int       $options
-     * @param bool|null $state
-     *
-     * @throws \InvalidArgumentException
-     *
-     * @return $this
-     */
-    public function toggleOptions($options, $state = null)
-    {
-        if ($state === null) {
-            $state = ($this->options & $options) !== $options;
-        }
-
-        return $this->setOptions(
-            $state ?
-            $this->options | $options :
-            $this->options & ~$options
-        );
-    }
-
-    /**
-     * Toggle EXCLUDE_START_DATE option.
-     *
-     * @param bool $state
-     *
-     * @return $this
-     */
-    public function excludeStartDate($state = true)
-    {
-        return $this->toggleOptions(static::EXCLUDE_START_DATE, $state);
-    }
-
-    /**
-     * Toggle EXCLUDE_END_DATE option.
-     *
-     * @param bool $state
-     *
-     * @return $this
-     */
-    public function excludeEndDate($state = true)
-    {
-        return $this->toggleOptions(static::EXCLUDE_END_DATE, $state);
-    }
-
-    /**
-     * Get the underlying date interval.
-     *
-     * @return CarbonInterval
-     */
-    public function getDateInterval()
-    {
-        return $this->dateInterval->copy();
-    }
-
-    /**
-     * Get start date of the period.
-     *
-     * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
-     *
-     * @return CarbonInterface
-     */
-    public function getStartDate(string $rounding = null)
-    {
-        $date = $this->startDate->avoidMutation();
-
-        return $rounding ? $date->round($this->getDateInterval(), $rounding) : $date;
-    }
-
-    /**
-     * Get end date of the period.
-     *
-     * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
-     *
-     * @return CarbonInterface|null
-     */
-    public function getEndDate(string $rounding = null)
-    {
-        if (!$this->endDate) {
-            return null;
-        }
-
-        $date = $this->endDate->avoidMutation();
-
-        return $rounding ? $date->round($this->getDateInterval(), $rounding) : $date;
-    }
-
-    /**
-     * Get number of recurrences.
-     *
-     * @return int|float|null
-     */
-    public function getRecurrences()
-    {
-        return $this->recurrences;
-    }
-
-    /**
-     * Returns true if the start date should be excluded.
-     *
-     * @return bool
-     */
-    public function isStartExcluded()
-    {
-        return ($this->options & static::EXCLUDE_START_DATE) !== 0;
-    }
-
-    /**
-     * Returns true if the end date should be excluded.
-     *
-     * @return bool
-     */
-    public function isEndExcluded()
-    {
-        return ($this->options & static::EXCLUDE_END_DATE) !== 0;
-    }
-
-    /**
-     * Returns true if the start date should be included.
-     *
-     * @return bool
-     */
-    public function isStartIncluded()
-    {
-        return !$this->isStartExcluded();
-    }
-
-    /**
-     * Returns true if the end date should be included.
-     *
-     * @return bool
-     */
-    public function isEndIncluded()
-    {
-        return !$this->isEndExcluded();
-    }
-
-    /**
-     * Return the start if it's included by option, else return the start + 1 period interval.
-     *
-     * @return CarbonInterface
-     */
-    public function getIncludedStartDate()
-    {
-        $start = $this->getStartDate();
-
-        if ($this->isStartExcluded()) {
-            return $start->add($this->getDateInterval());
-        }
-
-        return $start;
-    }
-
-    /**
-     * Return the end if it's included by option, else return the end - 1 period interval.
-     * Warning: if the period has no fixed end, this method will iterate the period to calculate it.
-     *
-     * @return CarbonInterface
-     */
-    public function getIncludedEndDate()
-    {
-        $end = $this->getEndDate();
-
-        if (!$end) {
-            return $this->calculateEnd();
-        }
-
-        if ($this->isEndExcluded()) {
-            return $end->sub($this->getDateInterval());
-        }
-
-        return $end;
-    }
-
-    /**
-     * Add a filter to the stack.
-     *
-     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
-     *
-     * @param callable $callback
-     * @param string   $name
-     *
-     * @return $this
-     */
-    public function addFilter($callback, $name = null)
-    {
-        $tuple = $this->createFilterTuple(\func_get_args());
-
-        $this->filters[] = $tuple;
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Prepend a filter to the stack.
-     *
-     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
-     *
-     * @param callable $callback
-     * @param string   $name
-     *
-     * @return $this
-     */
-    public function prependFilter($callback, $name = null)
-    {
-        $tuple = $this->createFilterTuple(\func_get_args());
-
-        array_unshift($this->filters, $tuple);
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Remove a filter by instance or name.
-     *
-     * @param callable|string $filter
-     *
-     * @return $this
-     */
-    public function removeFilter($filter)
-    {
-        $key = \is_callable($filter) ? 0 : 1;
-
-        $this->filters = array_values(array_filter(
-            $this->filters,
-            function ($tuple) use ($key, $filter) {
-                return $tuple[$key] !== $filter;
-            }
-        ));
-
-        $this->updateInternalState();
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Return whether given instance or name is in the filter stack.
-     *
-     * @param callable|string $filter
-     *
-     * @return bool
-     */
-    public function hasFilter($filter)
-    {
-        $key = \is_callable($filter) ? 0 : 1;
-
-        foreach ($this->filters as $tuple) {
-            if ($tuple[$key] === $filter) {
-                return true;
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * Get filters stack.
-     *
-     * @return array
-     */
-    public function getFilters()
-    {
-        return $this->filters;
-    }
-
-    /**
-     * Set filters stack.
-     *
-     * @param array $filters
-     *
-     * @return $this
-     */
-    public function setFilters(array $filters)
-    {
-        $this->filters = $filters;
-
-        $this->updateInternalState();
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Reset filters stack.
-     *
-     * @return $this
-     */
-    public function resetFilters()
-    {
-        $this->filters = [];
-
-        if ($this->endDate !== null) {
-            $this->filters[] = [static::END_DATE_FILTER, null];
-        }
-
-        if ($this->recurrences !== null) {
-            $this->filters[] = [static::RECURRENCES_FILTER, null];
-        }
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Add a recurrences filter (set maximum number of recurrences).
-     *
-     * @param int|float|null $recurrences
-     *
-     * @throws InvalidArgumentException
-     *
-     * @return $this
-     */
-    public function setRecurrences($recurrences)
-    {
-        if ((!is_numeric($recurrences) && $recurrences !== null) || $recurrences < 0) {
-            throw new InvalidPeriodParameterException('Invalid number of recurrences.');
-        }
-
-        if ($recurrences === null) {
-            return $this->removeFilter(static::RECURRENCES_FILTER);
-        }
-
-        $this->recurrences = $recurrences === INF ? INF : (int) $recurrences;
-
-        if (!$this->hasFilter(static::RECURRENCES_FILTER)) {
-            return $this->addFilter(static::RECURRENCES_FILTER);
-        }
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Change the period start date.
-     *
-     * @param DateTime|DateTimeInterface|string $date
-     * @param bool|null                         $inclusive
-     *
-     * @throws InvalidPeriodDateException
-     *
-     * @return $this
-     */
-    public function setStartDate($date, $inclusive = null)
-    {
-        if (!$this->isInfiniteDate($date) && !($date = ([$this->dateClass, 'make'])($date))) {
-            throw new InvalidPeriodDateException('Invalid start date.');
-        }
-
-        $this->startDate = $date;
-
-        if ($inclusive !== null) {
-            $this->toggleOptions(static::EXCLUDE_START_DATE, !$inclusive);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Change the period end date.
-     *
-     * @param DateTime|DateTimeInterface|string|null $date
-     * @param bool|null                              $inclusive
-     *
-     * @throws \InvalidArgumentException
-     *
-     * @return $this
-     */
-    public function setEndDate($date, $inclusive = null)
-    {
-        if ($date !== null && !$this->isInfiniteDate($date) && !$date = ([$this->dateClass, 'make'])($date)) {
-            throw new InvalidPeriodDateException('Invalid end date.');
-        }
-
-        if (!$date) {
-            return $this->removeFilter(static::END_DATE_FILTER);
-        }
-
-        $this->endDate = $date;
-
-        if ($inclusive !== null) {
-            $this->toggleOptions(static::EXCLUDE_END_DATE, !$inclusive);
-        }
-
-        if (!$this->hasFilter(static::END_DATE_FILTER)) {
-            return $this->addFilter(static::END_DATE_FILTER);
-        }
-
-        $this->handleChangedParameters();
-
-        return $this;
-    }
-
-    /**
-     * Check if the current position is valid.
-     *
-     * @return bool
-     */
-    #[ReturnTypeWillChange]
-    public function valid()
-    {
-        return $this->validateCurrentDate() === true;
-    }
-
-    /**
-     * Return the current key.
-     *
-     * @return int|null
-     */
-    #[ReturnTypeWillChange]
-    public function key()
-    {
-        return $this->valid()
-            ? $this->key
-            : null;
-    }
-
-    /**
-     * Return the current date.
-     *
-     * @return CarbonInterface|null
-     */
-    #[ReturnTypeWillChange]
-    public function current()
-    {
-        return $this->valid()
-            ? $this->prepareForReturn($this->current)
-            : null;
-    }
-
-    /**
-     * Move forward to the next date.
-     *
-     * @throws RuntimeException
-     *
-     * @return void
-     */
-    #[ReturnTypeWillChange]
-    public function next()
-    {
-        if ($this->current === null) {
-            $this->rewind();
-        }
-
-        if ($this->validationResult !== static::END_ITERATION) {
-            $this->key++;
-
-            $this->incrementCurrentDateUntilValid();
-        }
-    }
-
-    /**
-     * Rewind to the start date.
-     *
-     * Iterating over a date in the UTC timezone avoids bug during backward DST change.
-     *
-     * @see https://bugs.php.net/bug.php?id=72255
-     * @see https://bugs.php.net/bug.php?id=74274
-     * @see https://wiki.php.net/rfc/datetime_and_daylight_saving_time
-     *
-     * @throws RuntimeException
-     *
-     * @return void
-     */
-    #[ReturnTypeWillChange]
-    public function rewind()
-    {
-        $this->key = 0;
-        $this->current = ([$this->dateClass, 'make'])($this->startDate);
-        $settings = $this->getSettings();
-
-        if ($this->hasLocalTranslator()) {
-            $settings['locale'] = $this->getTranslatorLocale();
-        }
-
-        $this->current->settings($settings);
-        $this->timezone = static::intervalHasTime($this->dateInterval) ? $this->current->getTimezone() : null;
-
-        if ($this->timezone) {
-            $this->current = $this->current->utc();
-        }
-
-        $this->validationResult = null;
-
-        if ($this->isStartExcluded() || $this->validateCurrentDate() === false) {
-            $this->incrementCurrentDateUntilValid();
-        }
-    }
-
-    /**
-     * Skip iterations and returns iteration state (false if ended, true if still valid).
-     *
-     * @param int $count steps number to skip (1 by default)
-     *
-     * @return bool
-     */
-    public function skip($count = 1)
-    {
-        for ($i = $count; $this->valid() && $i > 0; $i--) {
-            $this->next();
-        }
-
-        return $this->valid();
-    }
-
-    /**
-     * Format the date period as ISO 8601.
-     *
-     * @return string
-     */
-    public function toIso8601String()
-    {
-        $parts = [];
-
-        if ($this->recurrences !== null) {
-            $parts[] = 'R'.$this->recurrences;
-        }
-
-        $parts[] = $this->startDate->toIso8601String();
-
-        $parts[] = $this->dateInterval->spec();
-
-        if ($this->endDate !== null) {
-            $parts[] = $this->endDate->toIso8601String();
-        }
-
-        return implode('/', $parts);
-    }
-
-    /**
-     * Convert the date period into a string.
-     *
-     * @return string
-     */
-    public function toString()
-    {
-        $translator = ([$this->dateClass, 'getTranslator'])();
-
-        $parts = [];
-
-        $format = !$this->startDate->isStartOfDay() || ($this->endDate && !$this->endDate->isStartOfDay())
-            ? 'Y-m-d H:i:s'
-            : 'Y-m-d';
-
-        if ($this->recurrences !== null) {
-            $parts[] = $this->translate('period_recurrences', [], $this->recurrences, $translator);
-        }
-
-        $parts[] = $this->translate('period_interval', [':interval' => $this->dateInterval->forHumans([
-            'join' => true,
-        ])], null, $translator);
-
-        $parts[] = $this->translate('period_start_date', [':date' => $this->startDate->rawFormat($format)], null, $translator);
-
-        if ($this->endDate !== null) {
-            $parts[] = $this->translate('period_end_date', [':date' => $this->endDate->rawFormat($format)], null, $translator);
-        }
-
-        $result = implode(' ', $parts);
-
-        return mb_strtoupper(mb_substr($result, 0, 1)).mb_substr($result, 1);
-    }
-
-    /**
-     * Format the date period as ISO 8601.
-     *
-     * @return string
-     */
-    public function spec()
-    {
-        return $this->toIso8601String();
-    }
-
-    /**
-     * Cast the current instance into the given class.
-     *
-     * @param string $className The $className::instance() method will be called to cast the current object.
-     *
-     * @return DatePeriod
-     */
-    public function cast(string $className)
-    {
-        if (!method_exists($className, 'instance')) {
-            if (is_a($className, DatePeriod::class, true)) {
-                return new $className(
-                    $this->rawDate($this->getStartDate()),
-                    $this->getDateInterval(),
-                    $this->getEndDate() ? $this->rawDate($this->getIncludedEndDate()) : $this->getRecurrences(),
-                    $this->isStartExcluded() ? DatePeriod::EXCLUDE_START_DATE : 0
-                );
-            }
-
-            throw new InvalidCastException("$className has not the instance() method needed to cast the date.");
-        }
-
-        return $className::instance($this);
-    }
-
-    /**
-     * Return native DatePeriod PHP object matching the current instance.
-     *
-     * @example
-     * ```
-     * var_dump(CarbonPeriod::create('2021-01-05', '2021-02-15')->toDatePeriod());
-     * ```
-     *
-     * @return DatePeriod
-     */
-    public function toDatePeriod()
-    {
-        return $this->cast(DatePeriod::class);
-    }
-
-    /**
-     * Return `true` if the period has no custom filter and is guaranteed to be endless.
-     *
-     * Note that we can't check if a period is endless as soon as it has custom filters
-     * because filters can emit `CarbonPeriod::END_ITERATION` to stop the iteration in
-     * a way we can't predict without actually iterating the period.
-     */
-    public function isUnfilteredAndEndLess(): bool
-    {
-        foreach ($this->filters as $filter) {
-            switch ($filter) {
-                case [static::RECURRENCES_FILTER, null]:
-                    if ($this->recurrences !== null && is_finite($this->recurrences)) {
-                        return false;
-                    }
-
-                    break;
-
-                case [static::END_DATE_FILTER, null]:
-                    if ($this->endDate !== null && !$this->endDate->isEndOfTime()) {
-                        return false;
-                    }
-
-                    break;
-
-                default:
-                    return false;
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * Convert the date period into an array without changing current iteration state.
-     *
-     * @return CarbonInterface[]
-     */
-    public function toArray()
-    {
-        if ($this->isUnfilteredAndEndLess()) {
-            throw new EndLessPeriodException("Endless period can't be converted to array nor counted.");
-        }
-
-        $state = [
-            $this->key,
-            $this->current ? $this->current->avoidMutation() : null,
-            $this->validationResult,
-        ];
-
-        $result = iterator_to_array($this);
-
-        [$this->key, $this->current, $this->validationResult] = $state;
-
-        return $result;
-    }
-
-    /**
-     * Count dates in the date period.
-     *
-     * @return int
-     */
-    #[ReturnTypeWillChange]
-    public function count()
-    {
-        return \count($this->toArray());
-    }
-
-    /**
-     * Return the first date in the date period.
-     *
-     * @return CarbonInterface|null
-     */
-    public function first()
-    {
-        if ($this->isUnfilteredAndEndLess()) {
-            foreach ($this as $date) {
-                $this->rewind();
-
-                return $date;
-            }
-
-            return null;
-        }
-
-        return ($this->toArray() ?: [])[0] ?? null;
-    }
-
-    /**
-     * Return the last date in the date period.
-     *
-     * @return CarbonInterface|null
-     */
-    public function last()
-    {
-        $array = $this->toArray();
-
-        return $array ? $array[\count($array) - 1] : null;
-    }
-
-    /**
-     * Convert the date period into a string.
-     *
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->toString();
-    }
-
-    /**
-     * Add aliases for setters.
-     *
-     * CarbonPeriod::days(3)->hours(5)->invert()
-     *     ->sinceNow()->until('2010-01-10')
-     *     ->filter(...)
-     *     ->count()
-     *
-     * Note: We use magic method to let static and instance aliases with the same names.
-     *
-     * @param string $method
-     * @param array  $parameters
-     *
-     * @return mixed
-     */
-    public function __call($method, $parameters)
-    {
-        if (static::hasMacro($method)) {
-            return static::bindMacroContext($this, function () use (&$method, &$parameters) {
-                return $this->callMacro($method, $parameters);
-            });
-        }
-
-        $roundedValue = $this->callRoundMethod($method, $parameters);
-
-        if ($roundedValue !== null) {
-            return $roundedValue;
-        }
-
-        $first = \count($parameters) >= 1 ? $parameters[0] : null;
-        $second = \count($parameters) >= 2 ? $parameters[1] : null;
-
-        switch ($method) {
-            case 'start':
-            case 'since':
-                return $this->setStartDate($first, $second);
-
-            case 'sinceNow':
-                return $this->setStartDate(new Carbon(), $first);
-
-            case 'end':
-            case 'until':
-                return $this->setEndDate($first, $second);
-
-            case 'untilNow':
-                return $this->setEndDate(new Carbon(), $first);
-
-            case 'dates':
-            case 'between':
-                return $this->setDates($first, $second);
-
-            case 'recurrences':
-            case 'times':
-                return $this->setRecurrences($first);
-
-            case 'options':
-                return $this->setOptions($first);
-
-            case 'toggle':
-                return $this->toggleOptions($first, $second);
-
-            case 'filter':
-            case 'push':
-                return $this->addFilter($first, $second);
-
-            case 'prepend':
-                return $this->prependFilter($first, $second);
-
-            case 'filters':
-                return $this->setFilters($first ?: []);
-
-            case 'interval':
-            case 'each':
-            case 'every':
-            case 'step':
-            case 'stepBy':
-                return $this->setDateInterval($first);
-
-            case 'invert':
-                return $this->invertDateInterval();
-
-            case 'years':
-            case 'year':
-            case 'months':
-            case 'month':
-            case 'weeks':
-            case 'week':
-            case 'days':
-            case 'dayz':
-            case 'day':
-            case 'hours':
-            case 'hour':
-            case 'minutes':
-            case 'minute':
-            case 'seconds':
-            case 'second':
-                return $this->setDateInterval((
-                    // Override default P1D when instantiating via fluent setters.
-                    [$this->isDefaultInterval ? new CarbonInterval('PT0S') : $this->dateInterval, $method]
-                )(
-                    \count($parameters) === 0 ? 1 : $first
-                ));
-        }
-
-        if ($this->localStrictModeEnabled ?? Carbon::isStrictModeEnabled()) {
-            throw new UnknownMethodException($method);
-        }
-
-        return $this;
-    }
-
-    /**
-     * Set the instance's timezone from a string or object and apply it to start/end.
-     *
-     * @param \DateTimeZone|string $timezone
-     *
-     * @return static
-     */
-    public function setTimezone($timezone)
-    {
-        $this->tzName = $timezone;
-        $this->timezone = $timezone;
-
-        if ($this->startDate) {
-            $this->setStartDate($this->startDate->setTimezone($timezone));
-        }
-
-        if ($this->endDate) {
-            $this->setEndDate($this->endDate->setTimezone($timezone));
-        }
-
-        return $this;
-    }
-
-    /**
-     * Set the instance's timezone from a string or object and add/subtract the offset difference to start/end.
-     *
-     * @param \DateTimeZone|string $timezone
-     *
-     * @return static
-     */
-    public function shiftTimezone($timezone)
-    {
-        $this->tzName = $timezone;
-        $this->timezone = $timezone;
-
-        if ($this->startDate) {
-            $this->setStartDate($this->startDate->shiftTimezone($timezone));
-        }
-
-        if ($this->endDate) {
-            $this->setEndDate($this->endDate->shiftTimezone($timezone));
-        }
-
-        return $this;
-    }
-
-    /**
-     * Returns the end is set, else calculated from start an recurrences.
-     *
-     * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
-     *
-     * @return CarbonInterface
-     */
-    public function calculateEnd(string $rounding = null)
-    {
-        if ($end = $this->getEndDate($rounding)) {
-            return $end;
-        }
-
-        if ($this->dateInterval->isEmpty()) {
-            return $this->getStartDate($rounding);
-        }
-
-        $date = $this->getEndFromRecurrences() ?? $this->iterateUntilEnd();
-
-        if ($date && $rounding) {
-            $date = $date->avoidMutation()->round($this->getDateInterval(), $rounding);
-        }
-
-        return $date;
-    }
-
-    /**
-     * @return CarbonInterface|null
-     */
-    private function getEndFromRecurrences()
-    {
-        if ($this->recurrences === null) {
-            throw new UnreachableException(
-                "Could not calculate period end without either explicit end or recurrences.\n".
-                "If you're looking for a forever-period, use ->setRecurrences(INF)."
-            );
-        }
-
-        if ($this->recurrences === INF) {
-            $start = $this->getStartDate();
-
-            return $start < $start->avoidMutation()->add($this->getDateInterval())
-                ? CarbonImmutable::endOfTime()
-                : CarbonImmutable::startOfTime();
-        }
-
-        if ($this->filters === [[static::RECURRENCES_FILTER, null]]) {
-            return $this->getStartDate()->avoidMutation()->add(
-                $this->getDateInterval()->times(
-                    $this->recurrences - ($this->isStartExcluded() ? 0 : 1)
-                )
-            );
-        }
-
-        return null;
-    }
-
-    /**
-     * @return CarbonInterface|null
-     */
-    private function iterateUntilEnd()
-    {
-        $attempts = 0;
-        $date = null;
-
-        foreach ($this as $date) {
-            if (++$attempts > static::END_MAX_ATTEMPTS) {
-                throw new UnreachableException(
-                    'Could not calculate period end after iterating '.static::END_MAX_ATTEMPTS.' times.'
-                );
-            }
-        }
-
-        return $date;
-    }
-
-    /**
-     * Returns true if the current period overlaps the given one (if 1 parameter passed)
-     * or the period between 2 dates (if 2 parameters passed).
-     *
-     * @param CarbonPeriod|\DateTimeInterface|Carbon|CarbonImmutable|string $rangeOrRangeStart
-     * @param \DateTimeInterface|Carbon|CarbonImmutable|string|null         $rangeEnd
-     *
-     * @return bool
-     */
-    public function overlaps($rangeOrRangeStart, $rangeEnd = null)
-    {
-        $range = $rangeEnd ? static::create($rangeOrRangeStart, $rangeEnd) : $rangeOrRangeStart;
-
-        if (!($range instanceof self)) {
-            $range = static::create($range);
-        }
-
-        [$start, $end] = $this->orderCouple($this->getStartDate(), $this->calculateEnd());
-        [$rangeStart, $rangeEnd] = $this->orderCouple($range->getStartDate(), $range->calculateEnd());
-
-        return $end > $rangeStart && $rangeEnd > $start;
-    }
-
-    /**
-     * Execute a given function on each date of the period.
-     *
-     * @example
-     * ```
-     * Carbon::create('2020-11-29')->daysUntil('2020-12-24')->forEach(function (Carbon $date) {
-     *   echo $date->diffInDays('2020-12-25')." days before Christmas!\n";
-     * });
-     * ```
-     *
-     * @param callable $callback
-     */
-    public function forEach(callable $callback)
-    {
-        foreach ($this as $date) {
-            $callback($date);
-        }
-    }
-
-    /**
-     * Execute a given function on each date of the period and yield the result of this function.
-     *
-     * @example
-     * ```
-     * $period = Carbon::create('2020-11-29')->daysUntil('2020-12-24');
-     * echo implode("\n", iterator_to_array($period->map(function (Carbon $date) {
-     *   return $date->diffInDays('2020-12-25').' days before Christmas!';
-     * })));
-     * ```
-     *
-     * @param callable $callback
-     *
-     * @return \Generator
-     */
-    public function map(callable $callback)
-    {
-        foreach ($this as $date) {
-            yield $callback($date);
-        }
-    }
-
-    /**
-     * Determines if the instance is equal to another.
-     * Warning: if options differ, instances wil never be equal.
-     *
-     * @param mixed $period
-     *
-     * @see equalTo()
-     *
-     * @return bool
-     */
-    public function eq($period): bool
-    {
-        return $this->equalTo($period);
-    }
-
-    /**
-     * Determines if the instance is equal to another.
-     * Warning: if options differ, instances wil never be equal.
-     *
-     * @param mixed $period
-     *
-     * @return bool
-     */
-    public function equalTo($period): bool
-    {
-        if (!($period instanceof self)) {
-            $period = self::make($period);
-        }
-
-        $end = $this->getEndDate();
-
-        return $period !== null
-            && $this->getDateInterval()->eq($period->getDateInterval())
-            && $this->getStartDate()->eq($period->getStartDate())
-            && ($end ? $end->eq($period->getEndDate()) : $this->getRecurrences() === $period->getRecurrences())
-            && ($this->getOptions() & (~static::IMMUTABLE)) === ($period->getOptions() & (~static::IMMUTABLE));
-    }
-
-    /**
-     * Determines if the instance is not equal to another.
-     * Warning: if options differ, instances wil never be equal.
-     *
-     * @param mixed $period
-     *
-     * @see notEqualTo()
-     *
-     * @return bool
-     */
-    public function ne($period): bool
-    {
-        return $this->notEqualTo($period);
-    }
-
-    /**
-     * Determines if the instance is not equal to another.
-     * Warning: if options differ, instances wil never be equal.
-     *
-     * @param mixed $period
-     *
-     * @return bool
-     */
-    public function notEqualTo($period): bool
-    {
-        return !$this->eq($period);
-    }
-
-    /**
-     * Determines if the start date is before an other given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function startsBefore($date = null): bool
-    {
-        return $this->getStartDate()->lessThan($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the start date is before or the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function startsBeforeOrAt($date = null): bool
-    {
-        return $this->getStartDate()->lessThanOrEqualTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the start date is after an other given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function startsAfter($date = null): bool
-    {
-        return $this->getStartDate()->greaterThan($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the start date is after or the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function startsAfterOrAt($date = null): bool
-    {
-        return $this->getStartDate()->greaterThanOrEqualTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the start date is the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function startsAt($date = null): bool
-    {
-        return $this->getStartDate()->equalTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the end date is before an other given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function endsBefore($date = null): bool
-    {
-        return $this->calculateEnd()->lessThan($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the end date is before or the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function endsBeforeOrAt($date = null): bool
-    {
-        return $this->calculateEnd()->lessThanOrEqualTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the end date is after an other given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function endsAfter($date = null): bool
-    {
-        return $this->calculateEnd()->greaterThan($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the end date is after or the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function endsAfterOrAt($date = null): bool
-    {
-        return $this->calculateEnd()->greaterThanOrEqualTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Determines if the end date is the same as a given date.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @param mixed $date
-     *
-     * @return bool
-     */
-    public function endsAt($date = null): bool
-    {
-        return $this->calculateEnd()->equalTo($this->resolveCarbon($date));
-    }
-
-    /**
-     * Return true if start date is now or later.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @return bool
-     */
-    public function isStarted(): bool
-    {
-        return $this->startsBeforeOrAt();
-    }
-
-    /**
-     * Return true if end date is now or later.
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @return bool
-     */
-    public function isEnded(): bool
-    {
-        return $this->endsBeforeOrAt();
-    }
-
-    /**
-     * Return true if now is between start date (included) and end date (excluded).
-     * (Rather start/end are included by options is ignored.)
-     *
-     * @return bool
-     */
-    public function isInProgress(): bool
-    {
-        return $this->isStarted() && !$this->isEnded();
-    }
-
-    /**
-     * Round the current instance at the given unit with given precision if specified and the given function.
-     *
-     * @param string                              $unit
-     * @param float|int|string|\DateInterval|null $precision
-     * @param string                              $function
-     *
-     * @return $this
-     */
-    public function roundUnit($unit, $precision = 1, $function = 'round')
-    {
-        $this->setStartDate($this->getStartDate()->roundUnit($unit, $precision, $function));
-
-        if ($this->endDate) {
-            $this->setEndDate($this->getEndDate()->roundUnit($unit, $precision, $function));
-        }
-
-        $this->setDateInterval($this->getDateInterval()->roundUnit($unit, $precision, $function));
-
-        return $this;
-    }
-
-    /**
-     * Truncate the current instance at the given unit with given precision if specified.
-     *
-     * @param string                              $unit
-     * @param float|int|string|\DateInterval|null $precision
-     *
-     * @return $this
-     */
-    public function floorUnit($unit, $precision = 1)
-    {
-        return $this->roundUnit($unit, $precision, 'floor');
-    }
-
-    /**
-     * Ceil the current instance at the given unit with given precision if specified.
-     *
-     * @param string                              $unit
-     * @param float|int|string|\DateInterval|null $precision
-     *
-     * @return $this
-     */
-    public function ceilUnit($unit, $precision = 1)
-    {
-        return $this->roundUnit($unit, $precision, 'ceil');
-    }
-
-    /**
-     * Round the current instance second with given precision if specified (else period interval is used).
-     *
-     * @param float|int|string|\DateInterval|null $precision
-     * @param string                              $function
-     *
-     * @return $this
-     */
-    public function round($precision = null, $function = 'round')
-    {
-        return $this->roundWith(
-            $precision ?? $this->getDateInterval()->setLocalTranslator(TranslatorImmutable::get('en'))->forHumans(),
-            $function
-        );
-    }
-
-    /**
-     * Round the current instance second with given precision if specified (else period interval is used).
-     *
-     * @param float|int|string|\DateInterval|null $precision
-     *
-     * @return $this
-     */
-    public function floor($precision = null)
-    {
-        return $this->round($precision, 'floor');
-    }
-
-    /**
-     * Ceil the current instance second with given precision if specified (else period interval is used).
-     *
-     * @param float|int|string|\DateInterval|null $precision
-     *
-     * @return $this
-     */
-    public function ceil($precision = null)
-    {
-        return $this->round($precision, 'ceil');
-    }
-
-    /**
-     * Specify data which should be serialized to JSON.
-     *
-     * @link https://php.net/manual/en/jsonserializable.jsonserialize.php
-     *
-     * @return CarbonInterface[]
-     */
-    #[ReturnTypeWillChange]
-    public function jsonSerialize()
-    {
-        return $this->toArray();
-    }
-
-    /**
-     * Return true if the given date is between start and end.
-     *
-     * @param \Carbon\Carbon|\Carbon\CarbonPeriod|\Carbon\CarbonInterval|\DateInterval|\DatePeriod|\DateTimeInterface|string|null $date
-     *
-     * @return bool
-     */
-    public function contains($date = null): bool
-    {
-        $startMethod = 'startsBefore'.($this->isStartIncluded() ? 'OrAt' : '');
-        $endMethod = 'endsAfter'.($this->isEndIncluded() ? 'OrAt' : '');
-
-        return $this->$startMethod($date) && $this->$endMethod($date);
-    }
-
-    /**
-     * Return true if the current period follows a given other period (with no overlap).
-     * For instance, [2019-08-01 -> 2019-08-12] follows [2019-07-29 -> 2019-07-31]
-     * Note than in this example, follows() would be false if 2019-08-01 or 2019-07-31 was excluded by options.
-     *
-     * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
-     *
-     * @return bool
-     */
-    public function follows($period, ...$arguments): bool
-    {
-        $period = $this->resolveCarbonPeriod($period, ...$arguments);
-
-        return $this->getIncludedStartDate()->equalTo($period->getIncludedEndDate()->add($period->getDateInterval()));
-    }
-
-    /**
-     * Return true if the given other period follows the current one (with no overlap).
-     * For instance, [2019-07-29 -> 2019-07-31] is followed by [2019-08-01 -> 2019-08-12]
-     * Note than in this example, isFollowedBy() would be false if 2019-08-01 or 2019-07-31 was excluded by options.
-     *
-     * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
-     *
-     * @return bool
-     */
-    public function isFollowedBy($period, ...$arguments): bool
-    {
-        $period = $this->resolveCarbonPeriod($period, ...$arguments);
-
-        return $period->follows($this);
-    }
-
-    /**
-     * Return true if the given period either follows or is followed by the current one.
-     *
-     * @see follows()
-     * @see isFollowedBy()
-     *
-     * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
-     *
-     * @return bool
-     */
-    public function isConsecutiveWith($period, ...$arguments): bool
-    {
-        return $this->follows($period, ...$arguments) || $this->isFollowedBy($period, ...$arguments);
-    }
-
-    /**
-     * Update properties after removing built-in filters.
-     *
-     * @return void
-     */
-    protected function updateInternalState()
-    {
-        if (!$this->hasFilter(static::END_DATE_FILTER)) {
-            $this->endDate = null;
-        }
-
-        if (!$this->hasFilter(static::RECURRENCES_FILTER)) {
-            $this->recurrences = null;
-        }
-    }
-
-    /**
-     * Create a filter tuple from raw parameters.
-     *
-     * Will create an automatic filter callback for one of Carbon's is* methods.
-     *
-     * @param array $parameters
-     *
-     * @return array
-     */
-    protected function createFilterTuple(array $parameters)
-    {
-        $method = array_shift($parameters);
-
-        if (!$this->isCarbonPredicateMethod($method)) {
-            return [$method, array_shift($parameters)];
-        }
-
-        return [function ($date) use ($method, $parameters) {
-            return ([$date, $method])(...$parameters);
-        }, $method];
-    }
-
-    /**
-     * Return whether given callable is a string pointing to one of Carbon's is* methods
-     * and should be automatically converted to a filter callback.
-     *
-     * @param callable $callable
-     *
-     * @return bool
-     */
-    protected function isCarbonPredicateMethod($callable)
-    {
-        return \is_string($callable) && str_starts_with($callable, 'is') &&
-            (method_exists($this->dateClass, $callable) || ([$this->dateClass, 'hasMacro'])($callable));
-    }
-
-    /**
-     * Recurrences filter callback (limits number of recurrences).
-     *
-     * @SuppressWarnings(PHPMD.UnusedFormalParameter)
-     *
-     * @param \Carbon\Carbon $current
-     * @param int            $key
-     *
-     * @return bool|string
-     */
-    protected function filterRecurrences($current, $key)
-    {
-        if ($key < $this->recurrences) {
-            return true;
-        }
-
-        return static::END_ITERATION;
-    }
-
-    /**
-     * End date filter callback.
-     *
-     * @param \Carbon\Carbon $current
-     *
-     * @return bool|string
-     */
-    protected function filterEndDate($current)
-    {
-        if (!$this->isEndExcluded() && $current == $this->endDate) {
-            return true;
-        }
-
-        if ($this->dateInterval->invert ? $current > $this->endDate : $current < $this->endDate) {
-            return true;
-        }
-
-        return static::END_ITERATION;
-    }
-
-    /**
-     * End iteration filter callback.
-     *
-     * @return string
-     */
-    protected function endIteration()
-    {
-        return static::END_ITERATION;
-    }
-
-    /**
-     * Handle change of the parameters.
-     */
-    protected function handleChangedParameters()
-    {
-        if (($this->getOptions() & static::IMMUTABLE) && $this->dateClass === Carbon::class) {
-            $this->setDateClass(CarbonImmutable::class);
-        } elseif (!($this->getOptions() & static::IMMUTABLE) && $this->dateClass === CarbonImmutable::class) {
-            $this->setDateClass(Carbon::class);
-        }
-
-        $this->validationResult = null;
-    }
-
-    /**
-     * Validate current date and stop iteration when necessary.
-     *
-     * Returns true when current date is valid, false if it is not, or static::END_ITERATION
-     * when iteration should be stopped.
-     *
-     * @return bool|string
-     */
-    protected function validateCurrentDate()
-    {
-        if ($this->current === null) {
-            $this->rewind();
-        }
-
-        // Check after the first rewind to avoid repeating the initial validation.
-        return $this->validationResult ?? ($this->validationResult = $this->checkFilters());
-    }
-
-    /**
-     * Check whether current value and key pass all the filters.
-     *
-     * @return bool|string
-     */
-    protected function checkFilters()
-    {
-        $current = $this->prepareForReturn($this->current);
-
-        foreach ($this->filters as $tuple) {
-            $result = \call_user_func(
-                $tuple[0],
-                $current->avoidMutation(),
-                $this->key,
-                $this
-            );
-
-            if ($result === static::END_ITERATION) {
-                return static::END_ITERATION;
-            }
-
-            if (!$result) {
-                return false;
-            }
-        }
-
-        return true;
-    }
-
-    /**
-     * Prepare given date to be returned to the external logic.
-     *
-     * @param CarbonInterface $date
-     *
-     * @return CarbonInterface
-     */
-    protected function prepareForReturn(CarbonInterface $date)
-    {
-        $date = ([$this->dateClass, 'make'])($date);
-
-        if ($this->timezone) {
-            $date = $date->setTimezone($this->timezone);
-        }
-
-        return $date;
-    }
-
-    /**
-     * Keep incrementing the current date until a valid date is found or the iteration is ended.
-     *
-     * @throws RuntimeException
-     *
-     * @return void
-     */
-    protected function incrementCurrentDateUntilValid()
-    {
-        $attempts = 0;
-
-        do {
-            $this->current = $this->current->add($this->dateInterval);
-
-            $this->validationResult = null;
-
-            if (++$attempts > static::NEXT_MAX_ATTEMPTS) {
-                throw new UnreachableException('Could not find next valid date.');
-            }
-        } while ($this->validateCurrentDate() === false);
-    }
-
-    /**
-     * Call given macro.
-     *
-     * @param string $name
-     * @param array  $parameters
-     *
-     * @return mixed
-     */
-    protected function callMacro($name, $parameters)
-    {
-        $macro = static::$macros[$name];
-
-        if ($macro instanceof Closure) {
-            $boundMacro = @$macro->bindTo($this, static::class) ?: @$macro->bindTo(null, static::class);
-
-            return ($boundMacro ?: $macro)(...$parameters);
-        }
-
-        return $macro(...$parameters);
-    }
-
-    /**
-     * Return the Carbon instance passed through, a now instance in the same timezone
-     * if null given or parse the input if string given.
-     *
-     * @param \Carbon\Carbon|\Carbon\CarbonPeriod|\Carbon\CarbonInterval|\DateInterval|\DatePeriod|\DateTimeInterface|string|null $date
-     *
-     * @return \Carbon\CarbonInterface
-     */
-    protected function resolveCarbon($date = null)
-    {
-        return $this->getStartDate()->nowWithSameTz()->carbonize($date);
-    }
-
-    /**
-     * Resolve passed arguments or DatePeriod to a CarbonPeriod object.
-     *
-     * @param mixed $period
-     * @param mixed ...$arguments
-     *
-     * @return static
-     */
-    protected function resolveCarbonPeriod($period, ...$arguments)
-    {
-        if ($period instanceof self) {
-            return $period;
-        }
-
-        return $period instanceof DatePeriod
-            ? static::instance($period)
-            : static::create($period, ...$arguments);
-    }
-
-    private function orderCouple($first, $second): array
-    {
-        return $first > $second ? [$second, $first] : [$first, $second];
-    }
-
-    private function makeDateTime($value): ?DateTimeInterface
-    {
-        if ($value instanceof DateTimeInterface) {
-            return $value;
-        }
-
-        if (\is_string($value)) {
-            $value = trim($value);
-
-            if (!preg_match('/^P[\dT]/', $value) &&
-                !preg_match('/^R\d/', $value) &&
-                preg_match('/[a-z\d]/i', $value)
-            ) {
-                return Carbon::parse($value, $this->tzName);
-            }
-        }
-
-        return null;
-    }
-
-    private function isInfiniteDate($date): bool
-    {
-        return $date instanceof CarbonInterface && ($date->isEndOfTime() || $date->isStartOfTime());
-    }
-
-    private function rawDate($date): ?DateTimeInterface
-    {
-        if ($date === false || $date === null) {
-            return null;
-        }
-
-        if ($date instanceof CarbonInterface) {
-            return $date->isMutable()
-                ? $date->toDateTime()
-                : $date->toDateTimeImmutable();
-        }
-
-        if (\in_array(\get_class($date), [DateTime::class, DateTimeImmutable::class], true)) {
-            return $date;
-        }
-
-        $class = $date instanceof DateTime ? DateTime::class : DateTimeImmutable::class;
-
-        return new $class($date->format('Y-m-d H:i:s.u'), $date->getTimezone());
-    }
+	use IntervalRounding;
+	use Mixin {
+		Mixin::mixin as baseMixin;
+	}
+	use Options;
+
+	/**
+	 * Built-in filter for limit by recurrences.
+	 *
+	 * @var callable
+	 */
+	public const RECURRENCES_FILTER = [self::class, 'filterRecurrences'];
+
+	/**
+	 * Built-in filter for limit to an end.
+	 *
+	 * @var callable
+	 */
+	public const END_DATE_FILTER = [self::class, 'filterEndDate'];
+
+	/**
+	 * Special value which can be returned by filters to end iteration. Also a filter.
+	 *
+	 * @var callable
+	 */
+	public const END_ITERATION = [self::class, 'endIteration'];
+
+	/**
+	 * Exclude start date from iteration.
+	 *
+	 * @var int
+	 */
+	public const EXCLUDE_START_DATE = 1;
+
+	/**
+	 * Exclude end date from iteration.
+	 *
+	 * @var int
+	 */
+	public const EXCLUDE_END_DATE = 2;
+
+	/**
+	 * Yield CarbonImmutable instances.
+	 *
+	 * @var int
+	 */
+	public const IMMUTABLE = 4;
+
+	/**
+	 * Number of maximum attempts before giving up on finding next valid date.
+	 *
+	 * @var int
+	 */
+	public const NEXT_MAX_ATTEMPTS = 1000;
+
+	/**
+	 * Number of maximum attempts before giving up on finding end date.
+	 *
+	 * @var int
+	 */
+	public const END_MAX_ATTEMPTS = 10000;
+
+	/**
+	 * The registered macros.
+	 *
+	 * @var array
+	 */
+	protected static $macros = [];
+
+	/**
+	 * Date class of iteration items.
+	 *
+	 * @var string
+	 */
+	protected $dateClass = Carbon::class;
+
+	/**
+	 * Underlying date interval instance. Always present, one day by default.
+	 *
+	 * @var CarbonInterval
+	 */
+	protected $dateInterval;
+
+	/**
+	 * Whether current date interval was set by default.
+	 *
+	 * @var bool
+	 */
+	protected $isDefaultInterval;
+
+	/**
+	 * The filters stack.
+	 *
+	 * @var array
+	 */
+	protected $filters = [];
+
+	/**
+	 * Period start date. Applied on rewind. Always present, now by default.
+	 *
+	 * @var CarbonInterface
+	 */
+	protected $startDate;
+
+	/**
+	 * Period end date. For inverted interval should be before the start date. Applied via a filter.
+	 *
+	 * @var CarbonInterface|null
+	 */
+	protected $endDate;
+
+	/**
+	 * Limit for number of recurrences. Applied via a filter.
+	 *
+	 * @var int|null
+	 */
+	protected $recurrences;
+
+	/**
+	 * Iteration options.
+	 *
+	 * @var int
+	 */
+	protected $options;
+
+	/**
+	 * Index of current date. Always sequential, even if some dates are skipped by filters.
+	 * Equal to null only before the first iteration.
+	 *
+	 * @var int
+	 */
+	protected $key;
+
+	/**
+	 * Current date. May temporarily hold unaccepted value when looking for a next valid date.
+	 * Equal to null only before the first iteration.
+	 *
+	 * @var CarbonInterface
+	 */
+	protected $current;
+
+	/**
+	 * Timezone of current date. Taken from the start date.
+	 *
+	 * @var \DateTimeZone|null
+	 */
+	protected $timezone;
+
+	/**
+	 * The cached validation result for current date.
+	 *
+	 * @var bool|string|null
+	 */
+	protected $validationResult;
+
+	/**
+	 * Timezone handler for settings() method.
+	 *
+	 * @var mixed
+	 */
+	protected $tzName;
+
+	/**
+	 * Make a CarbonPeriod instance from given variable if possible.
+	 *
+	 * @param mixed $var
+	 *
+	 * @return static|null
+	 */
+	public static function make($var)
+	{
+		try {
+			return static::instance($var);
+		} catch (NotAPeriodException $e) {
+			return static::create($var);
+		}
+	}
+
+	/**
+	 * Create a new instance from a DatePeriod or CarbonPeriod object.
+	 *
+	 * @param CarbonPeriod|DatePeriod $period
+	 *
+	 * @return static
+	 */
+	public static function instance($period)
+	{
+		if ($period instanceof static) {
+			return $period->copy();
+		}
+
+		if ($period instanceof self) {
+			return new static(
+				$period->getStartDate(),
+				$period->getEndDate() ?: $period->getRecurrences(),
+				$period->getDateInterval(),
+				$period->getOptions()
+			);
+		}
+
+		if ($period instanceof DatePeriod) {
+			return new static(
+				$period->start,
+				$period->end ?: ($period->recurrences - 1),
+				$period->interval,
+				$period->include_start_date ? 0 : static::EXCLUDE_START_DATE
+			);
+		}
+
+		$class = static::class;
+		$type = \gettype($period);
+
+		throw new NotAPeriodException(
+			'Argument 1 passed to '.$class.'::'.__METHOD__.'() '.
+			'must be an instance of DatePeriod or '.$class.', '.
+			($type === 'object' ? 'instance of '.\get_class($period) : $type).' given.'
+		);
+	}
+
+	/**
+	 * Create a new instance.
+	 *
+	 * @return static
+	 */
+	public static function create(...$params)
+	{
+		return static::createFromArray($params);
+	}
+
+	/**
+	 * Create a new instance from an array of parameters.
+	 *
+	 * @param array $params
+	 *
+	 * @return static
+	 */
+	public static function createFromArray(array $params)
+	{
+		return new static(...$params);
+	}
+
+	/**
+	 * Create CarbonPeriod from ISO 8601 string.
+	 *
+	 * @param string   $iso
+	 * @param int|null $options
+	 *
+	 * @return static
+	 */
+	public static function createFromIso($iso, $options = null)
+	{
+		$params = static::parseIso8601($iso);
+
+		$instance = static::createFromArray($params);
+
+		if ($options !== null) {
+			$instance->setOptions($options);
+		}
+
+		return $instance;
+	}
+
+	/**
+	 * Return whether given interval contains non zero value of any time unit.
+	 *
+	 * @param \DateInterval $interval
+	 *
+	 * @return bool
+	 */
+	protected static function intervalHasTime(DateInterval $interval)
+	{
+		return $interval->h || $interval->i || $interval->s || $interval->f;
+	}
+
+	/**
+	 * Return whether given variable is an ISO 8601 specification.
+	 *
+	 * Note: Check is very basic, as actual validation will be done later when parsing.
+	 * We just want to ensure that variable is not any other type of a valid parameter.
+	 *
+	 * @param mixed $var
+	 *
+	 * @return bool
+	 */
+	protected static function isIso8601($var)
+	{
+		if (!\is_string($var)) {
+			return false;
+		}
+
+		// Match slash but not within a timezone name.
+		$part = '[a-z]+(?:[_-][a-z]+)*';
+
+		preg_match("#\b$part/$part\b|(/)#i", $var, $match);
+
+		return isset($match[1]);
+	}
+
+	/**
+	 * Parse given ISO 8601 string into an array of arguments.
+	 *
+	 * @SuppressWarnings(PHPMD.ElseExpression)
+	 *
+	 * @param string $iso
+	 *
+	 * @return array
+	 */
+	protected static function parseIso8601($iso)
+	{
+		$result = [];
+
+		$interval = null;
+		$start = null;
+		$end = null;
+
+		foreach (explode('/', $iso) as $key => $part) {
+			if ($key === 0 && preg_match('/^R(\d*|INF)$/', $part, $match)) {
+				$parsed = \strlen($match[1]) ? (($match[1] !== 'INF') ? (int) $match[1] : INF) : null;
+			} elseif ($interval === null && $parsed = CarbonInterval::make($part)) {
+				$interval = $part;
+			} elseif ($start === null && $parsed = Carbon::make($part)) {
+				$start = $part;
+			} elseif ($end === null && $parsed = Carbon::make(static::addMissingParts($start ?? '', $part))) {
+				$end = $part;
+			} else {
+				throw new InvalidPeriodParameterException("Invalid ISO 8601 specification: $iso.");
+			}
+
+			$result[] = $parsed;
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Add missing parts of the target date from the soure date.
+	 *
+	 * @param string $source
+	 * @param string $target
+	 *
+	 * @return string
+	 */
+	protected static function addMissingParts($source, $target)
+	{
+		$pattern = '/'.preg_replace('/\d+/', '[0-9]+', preg_quote($target, '/')).'$/';
+
+		$result = preg_replace($pattern, $target, $source, 1, $count);
+
+		return $count ? $result : $target;
+	}
+
+	/**
+	 * Register a custom macro.
+	 *
+	 * @example
+	 * ```
+	 * CarbonPeriod::macro('middle', function () {
+	 *   return $this->getStartDate()->average($this->getEndDate());
+	 * });
+	 * echo CarbonPeriod::since('2011-05-12')->until('2011-06-03')->middle();
+	 * ```
+	 *
+	 * @param string          $name
+	 * @param object|callable $macro
+	 *
+	 * @return void
+	 */
+	public static function macro($name, $macro)
+	{
+		static::$macros[$name] = $macro;
+	}
+
+	/**
+	 * Register macros from a mixin object.
+	 *
+	 * @example
+	 * ```
+	 * CarbonPeriod::mixin(new class {
+	 *   public function addDays() {
+	 *     return function ($count = 1) {
+	 *       return $this->setStartDate(
+	 *         $this->getStartDate()->addDays($count)
+	 *       )->setEndDate(
+	 *         $this->getEndDate()->addDays($count)
+	 *       );
+	 *     };
+	 *   }
+	 *   public function subDays() {
+	 *     return function ($count = 1) {
+	 *       return $this->setStartDate(
+	 *         $this->getStartDate()->subDays($count)
+	 *       )->setEndDate(
+	 *         $this->getEndDate()->subDays($count)
+	 *       );
+	 *     };
+	 *   }
+	 * });
+	 * echo CarbonPeriod::create('2000-01-01', '2000-02-01')->addDays(5)->subDays(3);
+	 * ```
+	 *
+	 * @param object|string $mixin
+	 *
+	 * @throws ReflectionException
+	 *
+	 * @return void
+	 */
+	public static function mixin($mixin)
+	{
+		static::baseMixin($mixin);
+	}
+
+	/**
+	 * Check if macro is registered.
+	 *
+	 * @param string $name
+	 *
+	 * @return bool
+	 */
+	public static function hasMacro($name)
+	{
+		return isset(static::$macros[$name]);
+	}
+
+	/**
+	 * Provide static proxy for instance aliases.
+	 *
+	 * @param string $method
+	 * @param array  $parameters
+	 *
+	 * @return mixed
+	 */
+	public static function __callStatic($method, $parameters)
+	{
+		$date = new static();
+
+		if (static::hasMacro($method)) {
+			return static::bindMacroContext(null, function () use (&$method, &$parameters, &$date) {
+				return $date->callMacro($method, $parameters);
+			});
+		}
+
+		return $date->$method(...$parameters);
+	}
+
+	/**
+	 * CarbonPeriod constructor.
+	 *
+	 * @SuppressWarnings(PHPMD.ElseExpression)
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct(...$arguments)
+	{
+		// Parse and assign arguments one by one. First argument may be an ISO 8601 spec,
+		// which will be first parsed into parts and then processed the same way.
+
+		$argumentsCount = \count($arguments);
+
+		if ($argumentsCount && static::isIso8601($iso = $arguments[0])) {
+			array_splice($arguments, 0, 1, static::parseIso8601($iso));
+		}
+
+		if ($argumentsCount === 1) {
+			if ($arguments[0] instanceof DatePeriod) {
+				$arguments = [
+					$arguments[0]->start,
+					$arguments[0]->end ?: ($arguments[0]->recurrences - 1),
+					$arguments[0]->interval,
+					$arguments[0]->include_start_date ? 0 : static::EXCLUDE_START_DATE,
+				];
+			} elseif ($arguments[0] instanceof self) {
+				$arguments = [
+					$arguments[0]->getStartDate(),
+					$arguments[0]->getEndDate() ?: $arguments[0]->getRecurrences(),
+					$arguments[0]->getDateInterval(),
+					$arguments[0]->getOptions(),
+				];
+			}
+		}
+
+		foreach ($arguments as $argument) {
+			$parsedDate = null;
+
+			if ($argument instanceof DateTimeZone) {
+				$this->setTimezone($argument);
+			} elseif ($this->dateInterval === null &&
+				(
+					(\is_string($argument) && preg_match(
+						'/^(-?\d(\d(?![\/-])|[^\d\/-]([\/-])?)*|P[T\d].*|(?:\h*\d+(?:\.\d+)?\h*[a-z]+)+)$/i',
+						$argument
+					)) ||
+					$argument instanceof DateInterval ||
+					$argument instanceof Closure
+				) &&
+				$parsedInterval = @CarbonInterval::make($argument)
+			) {
+				$this->setDateInterval($parsedInterval);
+			} elseif ($this->startDate === null && $parsedDate = $this->makeDateTime($argument)) {
+				$this->setStartDate($parsedDate);
+			} elseif ($this->endDate === null && ($parsedDate = $parsedDate ?? $this->makeDateTime($argument))) {
+				$this->setEndDate($parsedDate);
+			} elseif ($this->recurrences === null && $this->endDate === null && is_numeric($argument)) {
+				$this->setRecurrences($argument);
+			} elseif ($this->options === null && (\is_int($argument) || $argument === null)) {
+				$this->setOptions($argument);
+			} else {
+				throw new InvalidPeriodParameterException('Invalid constructor parameters.');
+			}
+		}
+
+		if ($this->startDate === null) {
+			$this->setStartDate(Carbon::now());
+		}
+
+		if ($this->dateInterval === null) {
+			$this->setDateInterval(CarbonInterval::day());
+
+			$this->isDefaultInterval = true;
+		}
+
+		if ($this->options === null) {
+			$this->setOptions(0);
+		}
+	}
+
+	/**
+	 * Get a copy of the instance.
+	 *
+	 * @return static
+	 */
+	public function copy()
+	{
+		return clone $this;
+	}
+
+	/**
+	 * Get the getter for a property allowing both `DatePeriod` snakeCase and camelCase names.
+	 *
+	 * @param string $name
+	 *
+	 * @return callable|null
+	 */
+	protected function getGetter(string $name)
+	{
+		switch (strtolower(preg_replace('/[A-Z]/', '_$0', $name))) {
+			case 'start':
+			case 'start_date':
+				return [$this, 'getStartDate'];
+			case 'end':
+			case 'end_date':
+				return [$this, 'getEndDate'];
+			case 'interval':
+			case 'date_interval':
+				return [$this, 'getDateInterval'];
+			case 'recurrences':
+				return [$this, 'getRecurrences'];
+			case 'include_start_date':
+				return [$this, 'isStartIncluded'];
+			case 'include_end_date':
+				return [$this, 'isEndIncluded'];
+			case 'current':
+				return [$this, 'current'];
+			default:
+				return null;
+		}
+	}
+
+	/**
+	 * Get a property allowing both `DatePeriod` snakeCase and camelCase names.
+	 *
+	 * @param string $name
+	 *
+	 * @return bool|CarbonInterface|CarbonInterval|int|null
+	 */
+	public function get(string $name)
+	{
+		$getter = $this->getGetter($name);
+
+		if ($getter) {
+			return $getter();
+		}
+
+		throw new UnknownGetterException($name);
+	}
+
+	/**
+	 * Get a property allowing both `DatePeriod` snakeCase and camelCase names.
+	 *
+	 * @param string $name
+	 *
+	 * @return bool|CarbonInterface|CarbonInterval|int|null
+	 */
+	public function __get(string $name)
+	{
+		return $this->get($name);
+	}
+
+	/**
+	 * Check if an attribute exists on the object
+	 *
+	 * @param string $name
+	 *
+	 * @return bool
+	 */
+	public function __isset(string $name): bool
+	{
+		return $this->getGetter($name) !== null;
+	}
+
+	/**
+	 * @alias copy
+	 *
+	 * Get a copy of the instance.
+	 *
+	 * @return static
+	 */
+	public function clone()
+	{
+		return clone $this;
+	}
+
+	/**
+	 * Set the iteration item class.
+	 *
+	 * @param string $dateClass
+	 *
+	 * @return $this
+	 */
+	public function setDateClass(string $dateClass)
+	{
+		if (!is_a($dateClass, CarbonInterface::class, true)) {
+			throw new NotACarbonClassException($dateClass);
+		}
+
+		$this->dateClass = $dateClass;
+
+		if (is_a($dateClass, Carbon::class, true)) {
+			$this->toggleOptions(static::IMMUTABLE, false);
+		} elseif (is_a($dateClass, CarbonImmutable::class, true)) {
+			$this->toggleOptions(static::IMMUTABLE, true);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Returns iteration item date class.
+	 *
+	 * @return string
+	 */
+	public function getDateClass(): string
+	{
+		return $this->dateClass;
+	}
+
+	/**
+	 * Change the period date interval.
+	 *
+	 * @param DateInterval|string $interval
+	 *
+	 * @throws InvalidIntervalException
+	 *
+	 * @return $this
+	 */
+	public function setDateInterval($interval)
+	{
+		if (!$interval = CarbonInterval::make($interval)) {
+			throw new InvalidIntervalException('Invalid interval.');
+		}
+
+		if ($interval->spec() === 'PT0S' && !$interval->f && !$interval->getStep()) {
+			throw new InvalidIntervalException('Empty interval is not accepted.');
+		}
+
+		$this->dateInterval = $interval;
+
+		$this->isDefaultInterval = false;
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Invert the period date interval.
+	 *
+	 * @return $this
+	 */
+	public function invertDateInterval()
+	{
+		$interval = $this->dateInterval->invert();
+
+		return $this->setDateInterval($interval);
+	}
+
+	/**
+	 * Set start and end date.
+	 *
+	 * @param DateTime|DateTimeInterface|string      $start
+	 * @param DateTime|DateTimeInterface|string|null $end
+	 *
+	 * @return $this
+	 */
+	public function setDates($start, $end)
+	{
+		$this->setStartDate($start);
+		$this->setEndDate($end);
+
+		return $this;
+	}
+
+	/**
+	 * Change the period options.
+	 *
+	 * @param int|null $options
+	 *
+	 * @throws InvalidArgumentException
+	 *
+	 * @return $this
+	 */
+	public function setOptions($options)
+	{
+		if (!\is_int($options) && $options !== null) {
+			throw new InvalidPeriodParameterException('Invalid options.');
+		}
+
+		$this->options = $options ?: 0;
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Get the period options.
+	 *
+	 * @return int
+	 */
+	public function getOptions()
+	{
+		return $this->options;
+	}
+
+	/**
+	 * Toggle given options on or off.
+	 *
+	 * @param int       $options
+	 * @param bool|null $state
+	 *
+	 * @throws \InvalidArgumentException
+	 *
+	 * @return $this
+	 */
+	public function toggleOptions($options, $state = null)
+	{
+		if ($state === null) {
+			$state = ($this->options & $options) !== $options;
+		}
+
+		return $this->setOptions(
+			$state ?
+			$this->options | $options :
+			$this->options & ~$options
+		);
+	}
+
+	/**
+	 * Toggle EXCLUDE_START_DATE option.
+	 *
+	 * @param bool $state
+	 *
+	 * @return $this
+	 */
+	public function excludeStartDate($state = true)
+	{
+		return $this->toggleOptions(static::EXCLUDE_START_DATE, $state);
+	}
+
+	/**
+	 * Toggle EXCLUDE_END_DATE option.
+	 *
+	 * @param bool $state
+	 *
+	 * @return $this
+	 */
+	public function excludeEndDate($state = true)
+	{
+		return $this->toggleOptions(static::EXCLUDE_END_DATE, $state);
+	}
+
+	/**
+	 * Get the underlying date interval.
+	 *
+	 * @return CarbonInterval
+	 */
+	public function getDateInterval()
+	{
+		return $this->dateInterval->copy();
+	}
+
+	/**
+	 * Get start date of the period.
+	 *
+	 * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
+	 *
+	 * @return CarbonInterface
+	 */
+	public function getStartDate(string $rounding = null)
+	{
+		$date = $this->startDate->avoidMutation();
+
+		return $rounding ? $date->round($this->getDateInterval(), $rounding) : $date;
+	}
+
+	/**
+	 * Get end date of the period.
+	 *
+	 * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
+	 *
+	 * @return CarbonInterface|null
+	 */
+	public function getEndDate(string $rounding = null)
+	{
+		if (!$this->endDate) {
+			return null;
+		}
+
+		$date = $this->endDate->avoidMutation();
+
+		return $rounding ? $date->round($this->getDateInterval(), $rounding) : $date;
+	}
+
+	/**
+	 * Get number of recurrences.
+	 *
+	 * @return int|float|null
+	 */
+	public function getRecurrences()
+	{
+		return $this->recurrences;
+	}
+
+	/**
+	 * Returns true if the start date should be excluded.
+	 *
+	 * @return bool
+	 */
+	public function isStartExcluded()
+	{
+		return ($this->options & static::EXCLUDE_START_DATE) !== 0;
+	}
+
+	/**
+	 * Returns true if the end date should be excluded.
+	 *
+	 * @return bool
+	 */
+	public function isEndExcluded()
+	{
+		return ($this->options & static::EXCLUDE_END_DATE) !== 0;
+	}
+
+	/**
+	 * Returns true if the start date should be included.
+	 *
+	 * @return bool
+	 */
+	public function isStartIncluded()
+	{
+		return !$this->isStartExcluded();
+	}
+
+	/**
+	 * Returns true if the end date should be included.
+	 *
+	 * @return bool
+	 */
+	public function isEndIncluded()
+	{
+		return !$this->isEndExcluded();
+	}
+
+	/**
+	 * Return the start if it's included by option, else return the start + 1 period interval.
+	 *
+	 * @return CarbonInterface
+	 */
+	public function getIncludedStartDate()
+	{
+		$start = $this->getStartDate();
+
+		if ($this->isStartExcluded()) {
+			return $start->add($this->getDateInterval());
+		}
+
+		return $start;
+	}
+
+	/**
+	 * Return the end if it's included by option, else return the end - 1 period interval.
+	 * Warning: if the period has no fixed end, this method will iterate the period to calculate it.
+	 *
+	 * @return CarbonInterface
+	 */
+	public function getIncludedEndDate()
+	{
+		$end = $this->getEndDate();
+
+		if (!$end) {
+			return $this->calculateEnd();
+		}
+
+		if ($this->isEndExcluded()) {
+			return $end->sub($this->getDateInterval());
+		}
+
+		return $end;
+	}
+
+	/**
+	 * Add a filter to the stack.
+	 *
+	 * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+	 *
+	 * @param callable $callback
+	 * @param string   $name
+	 *
+	 * @return $this
+	 */
+	public function addFilter($callback, $name = null)
+	{
+		$tuple = $this->createFilterTuple(\func_get_args());
+
+		$this->filters[] = $tuple;
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Prepend a filter to the stack.
+	 *
+	 * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+	 *
+	 * @param callable $callback
+	 * @param string   $name
+	 *
+	 * @return $this
+	 */
+	public function prependFilter($callback, $name = null)
+	{
+		$tuple = $this->createFilterTuple(\func_get_args());
+
+		array_unshift($this->filters, $tuple);
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Remove a filter by instance or name.
+	 *
+	 * @param callable|string $filter
+	 *
+	 * @return $this
+	 */
+	public function removeFilter($filter)
+	{
+		$key = \is_callable($filter) ? 0 : 1;
+
+		$this->filters = array_values(array_filter(
+			$this->filters,
+			function ($tuple) use ($key, $filter) {
+				return $tuple[$key] !== $filter;
+			}
+		));
+
+		$this->updateInternalState();
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Return whether given instance or name is in the filter stack.
+	 *
+	 * @param callable|string $filter
+	 *
+	 * @return bool
+	 */
+	public function hasFilter($filter)
+	{
+		$key = \is_callable($filter) ? 0 : 1;
+
+		foreach ($this->filters as $tuple) {
+			if ($tuple[$key] === $filter) {
+				return true;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * Get filters stack.
+	 *
+	 * @return array
+	 */
+	public function getFilters()
+	{
+		return $this->filters;
+	}
+
+	/**
+	 * Set filters stack.
+	 *
+	 * @param array $filters
+	 *
+	 * @return $this
+	 */
+	public function setFilters(array $filters)
+	{
+		$this->filters = $filters;
+
+		$this->updateInternalState();
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Reset filters stack.
+	 *
+	 * @return $this
+	 */
+	public function resetFilters()
+	{
+		$this->filters = [];
+
+		if ($this->endDate !== null) {
+			$this->filters[] = [static::END_DATE_FILTER, null];
+		}
+
+		if ($this->recurrences !== null) {
+			$this->filters[] = [static::RECURRENCES_FILTER, null];
+		}
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Add a recurrences filter (set maximum number of recurrences).
+	 *
+	 * @param int|float|null $recurrences
+	 *
+	 * @throws InvalidArgumentException
+	 *
+	 * @return $this
+	 */
+	public function setRecurrences($recurrences)
+	{
+		if ((!is_numeric($recurrences) && $recurrences !== null) || $recurrences < 0) {
+			throw new InvalidPeriodParameterException('Invalid number of recurrences.');
+		}
+
+		if ($recurrences === null) {
+			return $this->removeFilter(static::RECURRENCES_FILTER);
+		}
+
+		$this->recurrences = $recurrences === INF ? INF : (int) $recurrences;
+
+		if (!$this->hasFilter(static::RECURRENCES_FILTER)) {
+			return $this->addFilter(static::RECURRENCES_FILTER);
+		}
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Change the period start date.
+	 *
+	 * @param DateTime|DateTimeInterface|string $date
+	 * @param bool|null                         $inclusive
+	 *
+	 * @throws InvalidPeriodDateException
+	 *
+	 * @return $this
+	 */
+	public function setStartDate($date, $inclusive = null)
+	{
+		if (!$this->isInfiniteDate($date) && !($date = ([$this->dateClass, 'make'])($date))) {
+			throw new InvalidPeriodDateException('Invalid start date.');
+		}
+
+		$this->startDate = $date;
+
+		if ($inclusive !== null) {
+			$this->toggleOptions(static::EXCLUDE_START_DATE, !$inclusive);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Change the period end date.
+	 *
+	 * @param DateTime|DateTimeInterface|string|null $date
+	 * @param bool|null                              $inclusive
+	 *
+	 * @throws \InvalidArgumentException
+	 *
+	 * @return $this
+	 */
+	public function setEndDate($date, $inclusive = null)
+	{
+		if ($date !== null && !$this->isInfiniteDate($date) && !$date = ([$this->dateClass, 'make'])($date)) {
+			throw new InvalidPeriodDateException('Invalid end date.');
+		}
+
+		if (!$date) {
+			return $this->removeFilter(static::END_DATE_FILTER);
+		}
+
+		$this->endDate = $date;
+
+		if ($inclusive !== null) {
+			$this->toggleOptions(static::EXCLUDE_END_DATE, !$inclusive);
+		}
+
+		if (!$this->hasFilter(static::END_DATE_FILTER)) {
+			return $this->addFilter(static::END_DATE_FILTER);
+		}
+
+		$this->handleChangedParameters();
+
+		return $this;
+	}
+
+	/**
+	 * Check if the current position is valid.
+	 *
+	 * @return bool
+	 */
+	#[ReturnTypeWillChange]
+	public function valid()
+	{
+		return $this->validateCurrentDate() === true;
+	}
+
+	/**
+	 * Return the current key.
+	 *
+	 * @return int|null
+	 */
+	#[ReturnTypeWillChange]
+	public function key()
+	{
+		return $this->valid()
+			? $this->key
+			: null;
+	}
+
+	/**
+	 * Return the current date.
+	 *
+	 * @return CarbonInterface|null
+	 */
+	#[ReturnTypeWillChange]
+	public function current()
+	{
+		return $this->valid()
+			? $this->prepareForReturn($this->current)
+			: null;
+	}
+
+	/**
+	 * Move forward to the next date.
+	 *
+	 * @throws RuntimeException
+	 *
+	 * @return void
+	 */
+	#[ReturnTypeWillChange]
+	public function next()
+	{
+		if ($this->current === null) {
+			$this->rewind();
+		}
+
+		if ($this->validationResult !== static::END_ITERATION) {
+			$this->key++;
+
+			$this->incrementCurrentDateUntilValid();
+		}
+	}
+
+	/**
+	 * Rewind to the start date.
+	 *
+	 * Iterating over a date in the UTC timezone avoids bug during backward DST change.
+	 *
+	 * @see https://bugs.php.net/bug.php?id=72255
+	 * @see https://bugs.php.net/bug.php?id=74274
+	 * @see https://wiki.php.net/rfc/datetime_and_daylight_saving_time
+	 *
+	 * @throws RuntimeException
+	 *
+	 * @return void
+	 */
+	#[ReturnTypeWillChange]
+	public function rewind()
+	{
+		$this->key = 0;
+		$this->current = ([$this->dateClass, 'make'])($this->startDate);
+		$settings = $this->getSettings();
+
+		if ($this->hasLocalTranslator()) {
+			$settings['locale'] = $this->getTranslatorLocale();
+		}
+
+		$this->current->settings($settings);
+		$this->timezone = static::intervalHasTime($this->dateInterval) ? $this->current->getTimezone() : null;
+
+		if ($this->timezone) {
+			$this->current = $this->current->utc();
+		}
+
+		$this->validationResult = null;
+
+		if ($this->isStartExcluded() || $this->validateCurrentDate() === false) {
+			$this->incrementCurrentDateUntilValid();
+		}
+	}
+
+	/**
+	 * Skip iterations and returns iteration state (false if ended, true if still valid).
+	 *
+	 * @param int $count steps number to skip (1 by default)
+	 *
+	 * @return bool
+	 */
+	public function skip($count = 1)
+	{
+		for ($i = $count; $this->valid() && $i > 0; $i--) {
+			$this->next();
+		}
+
+		return $this->valid();
+	}
+
+	/**
+	 * Format the date period as ISO 8601.
+	 *
+	 * @return string
+	 */
+	public function toIso8601String()
+	{
+		$parts = [];
+
+		if ($this->recurrences !== null) {
+			$parts[] = 'R'.$this->recurrences;
+		}
+
+		$parts[] = $this->startDate->toIso8601String();
+
+		$parts[] = $this->dateInterval->spec();
+
+		if ($this->endDate !== null) {
+			$parts[] = $this->endDate->toIso8601String();
+		}
+
+		return implode('/', $parts);
+	}
+
+	/**
+	 * Convert the date period into a string.
+	 *
+	 * @return string
+	 */
+	public function toString()
+	{
+		$translator = ([$this->dateClass, 'getTranslator'])();
+
+		$parts = [];
+
+		$format = !$this->startDate->isStartOfDay() || ($this->endDate && !$this->endDate->isStartOfDay())
+			? 'Y-m-d H:i:s'
+			: 'Y-m-d';
+
+		if ($this->recurrences !== null) {
+			$parts[] = $this->translate('period_recurrences', [], $this->recurrences, $translator);
+		}
+
+		$parts[] = $this->translate('period_interval', [':interval' => $this->dateInterval->forHumans([
+			'join' => true,
+		])], null, $translator);
+
+		$parts[] = $this->translate('period_start_date', [':date' => $this->startDate->rawFormat($format)], null, $translator);
+
+		if ($this->endDate !== null) {
+			$parts[] = $this->translate('period_end_date', [':date' => $this->endDate->rawFormat($format)], null, $translator);
+		}
+
+		$result = implode(' ', $parts);
+
+		return mb_strtoupper(mb_substr($result, 0, 1)).mb_substr($result, 1);
+	}
+
+	/**
+	 * Format the date period as ISO 8601.
+	 *
+	 * @return string
+	 */
+	public function spec()
+	{
+		return $this->toIso8601String();
+	}
+
+	/**
+	 * Cast the current instance into the given class.
+	 *
+	 * @param string $className The $className::instance() method will be called to cast the current object.
+	 *
+	 * @return DatePeriod
+	 */
+	public function cast(string $className)
+	{
+		if (!method_exists($className, 'instance')) {
+			if (is_a($className, DatePeriod::class, true)) {
+				return new $className(
+					$this->rawDate($this->getStartDate()),
+					$this->getDateInterval(),
+					$this->getEndDate() ? $this->rawDate($this->getIncludedEndDate()) : $this->getRecurrences(),
+					$this->isStartExcluded() ? DatePeriod::EXCLUDE_START_DATE : 0
+				);
+			}
+
+			throw new InvalidCastException("$className has not the instance() method needed to cast the date.");
+		}
+
+		return $className::instance($this);
+	}
+
+	/**
+	 * Return native DatePeriod PHP object matching the current instance.
+	 *
+	 * @example
+	 * ```
+	 * var_dump(CarbonPeriod::create('2021-01-05', '2021-02-15')->toDatePeriod());
+	 * ```
+	 *
+	 * @return DatePeriod
+	 */
+	public function toDatePeriod()
+	{
+		return $this->cast(DatePeriod::class);
+	}
+
+	/**
+	 * Return `true` if the period has no custom filter and is guaranteed to be endless.
+	 *
+	 * Note that we can't check if a period is endless as soon as it has custom filters
+	 * because filters can emit `CarbonPeriod::END_ITERATION` to stop the iteration in
+	 * a way we can't predict without actually iterating the period.
+	 */
+	public function isUnfilteredAndEndLess(): bool
+	{
+		foreach ($this->filters as $filter) {
+			switch ($filter) {
+				case [static::RECURRENCES_FILTER, null]:
+					if ($this->recurrences !== null && is_finite($this->recurrences)) {
+						return false;
+					}
+
+					break;
+
+				case [static::END_DATE_FILTER, null]:
+					if ($this->endDate !== null && !$this->endDate->isEndOfTime()) {
+						return false;
+					}
+
+					break;
+
+				default:
+					return false;
+			}
+		}
+
+		return true;
+	}
+
+	/**
+	 * Convert the date period into an array without changing current iteration state.
+	 *
+	 * @return CarbonInterface[]
+	 */
+	public function toArray()
+	{
+		if ($this->isUnfilteredAndEndLess()) {
+			throw new EndLessPeriodException("Endless period can't be converted to array nor counted.");
+		}
+
+		$state = [
+			$this->key,
+			$this->current ? $this->current->avoidMutation() : null,
+			$this->validationResult,
+		];
+
+		$result = iterator_to_array($this);
+
+		[$this->key, $this->current, $this->validationResult] = $state;
+
+		return $result;
+	}
+
+	/**
+	 * Count dates in the date period.
+	 *
+	 * @return int
+	 */
+	#[ReturnTypeWillChange]
+	public function count()
+	{
+		return \count($this->toArray());
+	}
+
+	/**
+	 * Return the first date in the date period.
+	 *
+	 * @return CarbonInterface|null
+	 */
+	public function first()
+	{
+		if ($this->isUnfilteredAndEndLess()) {
+			foreach ($this as $date) {
+				$this->rewind();
+
+				return $date;
+			}
+
+			return null;
+		}
+
+		return ($this->toArray() ?: [])[0] ?? null;
+	}
+
+	/**
+	 * Return the last date in the date period.
+	 *
+	 * @return CarbonInterface|null
+	 */
+	public function last()
+	{
+		$array = $this->toArray();
+
+		return $array ? $array[\count($array) - 1] : null;
+	}
+
+	/**
+	 * Convert the date period into a string.
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->toString();
+	}
+
+	/**
+	 * Add aliases for setters.
+	 *
+	 * CarbonPeriod::days(3)->hours(5)->invert()
+	 *     ->sinceNow()->until('2010-01-10')
+	 *     ->filter(...)
+	 *     ->count()
+	 *
+	 * Note: We use magic method to let static and instance aliases with the same names.
+	 *
+	 * @param string $method
+	 * @param array  $parameters
+	 *
+	 * @return mixed
+	 */
+	public function __call($method, $parameters)
+	{
+		if (static::hasMacro($method)) {
+			return static::bindMacroContext($this, function () use (&$method, &$parameters) {
+				return $this->callMacro($method, $parameters);
+			});
+		}
+
+		$roundedValue = $this->callRoundMethod($method, $parameters);
+
+		if ($roundedValue !== null) {
+			return $roundedValue;
+		}
+
+		$first = \count($parameters) >= 1 ? $parameters[0] : null;
+		$second = \count($parameters) >= 2 ? $parameters[1] : null;
+
+		switch ($method) {
+			case 'start':
+			case 'since':
+				return $this->setStartDate($first, $second);
+
+			case 'sinceNow':
+				return $this->setStartDate(new Carbon(), $first);
+
+			case 'end':
+			case 'until':
+				return $this->setEndDate($first, $second);
+
+			case 'untilNow':
+				return $this->setEndDate(new Carbon(), $first);
+
+			case 'dates':
+			case 'between':
+				return $this->setDates($first, $second);
+
+			case 'recurrences':
+			case 'times':
+				return $this->setRecurrences($first);
+
+			case 'options':
+				return $this->setOptions($first);
+
+			case 'toggle':
+				return $this->toggleOptions($first, $second);
+
+			case 'filter':
+			case 'push':
+				return $this->addFilter($first, $second);
+
+			case 'prepend':
+				return $this->prependFilter($first, $second);
+
+			case 'filters':
+				return $this->setFilters($first ?: []);
+
+			case 'interval':
+			case 'each':
+			case 'every':
+			case 'step':
+			case 'stepBy':
+				return $this->setDateInterval($first);
+
+			case 'invert':
+				return $this->invertDateInterval();
+
+			case 'years':
+			case 'year':
+			case 'months':
+			case 'month':
+			case 'weeks':
+			case 'week':
+			case 'days':
+			case 'dayz':
+			case 'day':
+			case 'hours':
+			case 'hour':
+			case 'minutes':
+			case 'minute':
+			case 'seconds':
+			case 'second':
+				return $this->setDateInterval((
+					// Override default P1D when instantiating via fluent setters.
+					[$this->isDefaultInterval ? new CarbonInterval('PT0S') : $this->dateInterval, $method]
+				)(
+					\count($parameters) === 0 ? 1 : $first
+				));
+		}
+
+		if ($this->localStrictModeEnabled ?? Carbon::isStrictModeEnabled()) {
+			throw new UnknownMethodException($method);
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Set the instance's timezone from a string or object and apply it to start/end.
+	 *
+	 * @param \DateTimeZone|string $timezone
+	 *
+	 * @return static
+	 */
+	public function setTimezone($timezone)
+	{
+		$this->tzName = $timezone;
+		$this->timezone = $timezone;
+
+		if ($this->startDate) {
+			$this->setStartDate($this->startDate->setTimezone($timezone));
+		}
+
+		if ($this->endDate) {
+			$this->setEndDate($this->endDate->setTimezone($timezone));
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Set the instance's timezone from a string or object and add/subtract the offset difference to start/end.
+	 *
+	 * @param \DateTimeZone|string $timezone
+	 *
+	 * @return static
+	 */
+	public function shiftTimezone($timezone)
+	{
+		$this->tzName = $timezone;
+		$this->timezone = $timezone;
+
+		if ($this->startDate) {
+			$this->setStartDate($this->startDate->shiftTimezone($timezone));
+		}
+
+		if ($this->endDate) {
+			$this->setEndDate($this->endDate->shiftTimezone($timezone));
+		}
+
+		return $this;
+	}
+
+	/**
+	 * Returns the end is set, else calculated from start an recurrences.
+	 *
+	 * @param string|null $rounding Optional rounding 'floor', 'ceil', 'round' using the period interval.
+	 *
+	 * @return CarbonInterface
+	 */
+	public function calculateEnd(string $rounding = null)
+	{
+		if ($end = $this->getEndDate($rounding)) {
+			return $end;
+		}
+
+		if ($this->dateInterval->isEmpty()) {
+			return $this->getStartDate($rounding);
+		}
+
+		$date = $this->getEndFromRecurrences() ?? $this->iterateUntilEnd();
+
+		if ($date && $rounding) {
+			$date = $date->avoidMutation()->round($this->getDateInterval(), $rounding);
+		}
+
+		return $date;
+	}
+
+	/**
+	 * @return CarbonInterface|null
+	 */
+	private function getEndFromRecurrences()
+	{
+		if ($this->recurrences === null) {
+			throw new UnreachableException(
+				"Could not calculate period end without either explicit end or recurrences.\n".
+				"If you're looking for a forever-period, use ->setRecurrences(INF)."
+			);
+		}
+
+		if ($this->recurrences === INF) {
+			$start = $this->getStartDate();
+
+			return $start < $start->avoidMutation()->add($this->getDateInterval())
+				? CarbonImmutable::endOfTime()
+				: CarbonImmutable::startOfTime();
+		}
+
+		if ($this->filters === [[static::RECURRENCES_FILTER, null]]) {
+			return $this->getStartDate()->avoidMutation()->add(
+				$this->getDateInterval()->times(
+					$this->recurrences - ($this->isStartExcluded() ? 0 : 1)
+				)
+			);
+		}
+
+		return null;
+	}
+
+	/**
+	 * @return CarbonInterface|null
+	 */
+	private function iterateUntilEnd()
+	{
+		$attempts = 0;
+		$date = null;
+
+		foreach ($this as $date) {
+			if (++$attempts > static::END_MAX_ATTEMPTS) {
+				throw new UnreachableException(
+					'Could not calculate period end after iterating '.static::END_MAX_ATTEMPTS.' times.'
+				);
+			}
+		}
+
+		return $date;
+	}
+
+	/**
+	 * Returns true if the current period overlaps the given one (if 1 parameter passed)
+	 * or the period between 2 dates (if 2 parameters passed).
+	 *
+	 * @param CarbonPeriod|\DateTimeInterface|Carbon|CarbonImmutable|string $rangeOrRangeStart
+	 * @param \DateTimeInterface|Carbon|CarbonImmutable|string|null         $rangeEnd
+	 *
+	 * @return bool
+	 */
+	public function overlaps($rangeOrRangeStart, $rangeEnd = null)
+	{
+		$range = $rangeEnd ? static::create($rangeOrRangeStart, $rangeEnd) : $rangeOrRangeStart;
+
+		if (!($range instanceof self)) {
+			$range = static::create($range);
+		}
+
+		[$start, $end] = $this->orderCouple($this->getStartDate(), $this->calculateEnd());
+		[$rangeStart, $rangeEnd] = $this->orderCouple($range->getStartDate(), $range->calculateEnd());
+
+		return $end > $rangeStart && $rangeEnd > $start;
+	}
+
+	/**
+	 * Execute a given function on each date of the period.
+	 *
+	 * @example
+	 * ```
+	 * Carbon::create('2020-11-29')->daysUntil('2020-12-24')->forEach(function (Carbon $date) {
+	 *   echo $date->diffInDays('2020-12-25')." days before Christmas!\n";
+	 * });
+	 * ```
+	 *
+	 * @param callable $callback
+	 */
+	public function forEach(callable $callback)
+	{
+		foreach ($this as $date) {
+			$callback($date);
+		}
+	}
+
+	/**
+	 * Execute a given function on each date of the period and yield the result of this function.
+	 *
+	 * @example
+	 * ```
+	 * $period = Carbon::create('2020-11-29')->daysUntil('2020-12-24');
+	 * echo implode("\n", iterator_to_array($period->map(function (Carbon $date) {
+	 *   return $date->diffInDays('2020-12-25').' days before Christmas!';
+	 * })));
+	 * ```
+	 *
+	 * @param callable $callback
+	 *
+	 * @return \Generator
+	 */
+	public function map(callable $callback)
+	{
+		foreach ($this as $date) {
+			yield $callback($date);
+		}
+	}
+
+	/**
+	 * Determines if the instance is equal to another.
+	 * Warning: if options differ, instances wil never be equal.
+	 *
+	 * @param mixed $period
+	 *
+	 * @see equalTo()
+	 *
+	 * @return bool
+	 */
+	public function eq($period): bool
+	{
+		return $this->equalTo($period);
+	}
+
+	/**
+	 * Determines if the instance is equal to another.
+	 * Warning: if options differ, instances wil never be equal.
+	 *
+	 * @param mixed $period
+	 *
+	 * @return bool
+	 */
+	public function equalTo($period): bool
+	{
+		if (!($period instanceof self)) {
+			$period = self::make($period);
+		}
+
+		$end = $this->getEndDate();
+
+		return $period !== null
+			&& $this->getDateInterval()->eq($period->getDateInterval())
+			&& $this->getStartDate()->eq($period->getStartDate())
+			&& ($end ? $end->eq($period->getEndDate()) : $this->getRecurrences() === $period->getRecurrences())
+			&& ($this->getOptions() & (~static::IMMUTABLE)) === ($period->getOptions() & (~static::IMMUTABLE));
+	}
+
+	/**
+	 * Determines if the instance is not equal to another.
+	 * Warning: if options differ, instances wil never be equal.
+	 *
+	 * @param mixed $period
+	 *
+	 * @see notEqualTo()
+	 *
+	 * @return bool
+	 */
+	public function ne($period): bool
+	{
+		return $this->notEqualTo($period);
+	}
+
+	/**
+	 * Determines if the instance is not equal to another.
+	 * Warning: if options differ, instances wil never be equal.
+	 *
+	 * @param mixed $period
+	 *
+	 * @return bool
+	 */
+	public function notEqualTo($period): bool
+	{
+		return !$this->eq($period);
+	}
+
+	/**
+	 * Determines if the start date is before an other given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function startsBefore($date = null): bool
+	{
+		return $this->getStartDate()->lessThan($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the start date is before or the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function startsBeforeOrAt($date = null): bool
+	{
+		return $this->getStartDate()->lessThanOrEqualTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the start date is after an other given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function startsAfter($date = null): bool
+	{
+		return $this->getStartDate()->greaterThan($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the start date is after or the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function startsAfterOrAt($date = null): bool
+	{
+		return $this->getStartDate()->greaterThanOrEqualTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the start date is the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function startsAt($date = null): bool
+	{
+		return $this->getStartDate()->equalTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the end date is before an other given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function endsBefore($date = null): bool
+	{
+		return $this->calculateEnd()->lessThan($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the end date is before or the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function endsBeforeOrAt($date = null): bool
+	{
+		return $this->calculateEnd()->lessThanOrEqualTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the end date is after an other given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function endsAfter($date = null): bool
+	{
+		return $this->calculateEnd()->greaterThan($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the end date is after or the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function endsAfterOrAt($date = null): bool
+	{
+		return $this->calculateEnd()->greaterThanOrEqualTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Determines if the end date is the same as a given date.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @param mixed $date
+	 *
+	 * @return bool
+	 */
+	public function endsAt($date = null): bool
+	{
+		return $this->calculateEnd()->equalTo($this->resolveCarbon($date));
+	}
+
+	/**
+	 * Return true if start date is now or later.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @return bool
+	 */
+	public function isStarted(): bool
+	{
+		return $this->startsBeforeOrAt();
+	}
+
+	/**
+	 * Return true if end date is now or later.
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @return bool
+	 */
+	public function isEnded(): bool
+	{
+		return $this->endsBeforeOrAt();
+	}
+
+	/**
+	 * Return true if now is between start date (included) and end date (excluded).
+	 * (Rather start/end are included by options is ignored.)
+	 *
+	 * @return bool
+	 */
+	public function isInProgress(): bool
+	{
+		return $this->isStarted() && !$this->isEnded();
+	}
+
+	/**
+	 * Round the current instance at the given unit with given precision if specified and the given function.
+	 *
+	 * @param string                              $unit
+	 * @param float|int|string|\DateInterval|null $precision
+	 * @param string                              $function
+	 *
+	 * @return $this
+	 */
+	public function roundUnit($unit, $precision = 1, $function = 'round')
+	{
+		$this->setStartDate($this->getStartDate()->roundUnit($unit, $precision, $function));
+
+		if ($this->endDate) {
+			$this->setEndDate($this->getEndDate()->roundUnit($unit, $precision, $function));
+		}
+
+		$this->setDateInterval($this->getDateInterval()->roundUnit($unit, $precision, $function));
+
+		return $this;
+	}
+
+	/**
+	 * Truncate the current instance at the given unit with given precision if specified.
+	 *
+	 * @param string                              $unit
+	 * @param float|int|string|\DateInterval|null $precision
+	 *
+	 * @return $this
+	 */
+	public function floorUnit($unit, $precision = 1)
+	{
+		return $this->roundUnit($unit, $precision, 'floor');
+	}
+
+	/**
+	 * Ceil the current instance at the given unit with given precision if specified.
+	 *
+	 * @param string                              $unit
+	 * @param float|int|string|\DateInterval|null $precision
+	 *
+	 * @return $this
+	 */
+	public function ceilUnit($unit, $precision = 1)
+	{
+		return $this->roundUnit($unit, $precision, 'ceil');
+	}
+
+	/**
+	 * Round the current instance second with given precision if specified (else period interval is used).
+	 *
+	 * @param float|int|string|\DateInterval|null $precision
+	 * @param string                              $function
+	 *
+	 * @return $this
+	 */
+	public function round($precision = null, $function = 'round')
+	{
+		return $this->roundWith(
+			$precision ?? $this->getDateInterval()->setLocalTranslator(TranslatorImmutable::get('en'))->forHumans(),
+			$function
+		);
+	}
+
+	/**
+	 * Round the current instance second with given precision if specified (else period interval is used).
+	 *
+	 * @param float|int|string|\DateInterval|null $precision
+	 *
+	 * @return $this
+	 */
+	public function floor($precision = null)
+	{
+		return $this->round($precision, 'floor');
+	}
+
+	/**
+	 * Ceil the current instance second with given precision if specified (else period interval is used).
+	 *
+	 * @param float|int|string|\DateInterval|null $precision
+	 *
+	 * @return $this
+	 */
+	public function ceil($precision = null)
+	{
+		return $this->round($precision, 'ceil');
+	}
+
+	/**
+	 * Specify data which should be serialized to JSON.
+	 *
+	 * @link https://php.net/manual/en/jsonserializable.jsonserialize.php
+	 *
+	 * @return CarbonInterface[]
+	 */
+	#[ReturnTypeWillChange]
+	public function jsonSerialize()
+	{
+		return $this->toArray();
+	}
+
+	/**
+	 * Return true if the given date is between start and end.
+	 *
+	 * @param \Carbon\Carbon|\Carbon\CarbonPeriod|\Carbon\CarbonInterval|\DateInterval|\DatePeriod|\DateTimeInterface|string|null $date
+	 *
+	 * @return bool
+	 */
+	public function contains($date = null): bool
+	{
+		$startMethod = 'startsBefore'.($this->isStartIncluded() ? 'OrAt' : '');
+		$endMethod = 'endsAfter'.($this->isEndIncluded() ? 'OrAt' : '');
+
+		return $this->$startMethod($date) && $this->$endMethod($date);
+	}
+
+	/**
+	 * Return true if the current period follows a given other period (with no overlap).
+	 * For instance, [2019-08-01 -> 2019-08-12] follows [2019-07-29 -> 2019-07-31]
+	 * Note than in this example, follows() would be false if 2019-08-01 or 2019-07-31 was excluded by options.
+	 *
+	 * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
+	 *
+	 * @return bool
+	 */
+	public function follows($period, ...$arguments): bool
+	{
+		$period = $this->resolveCarbonPeriod($period, ...$arguments);
+
+		return $this->getIncludedStartDate()->equalTo($period->getIncludedEndDate()->add($period->getDateInterval()));
+	}
+
+	/**
+	 * Return true if the given other period follows the current one (with no overlap).
+	 * For instance, [2019-07-29 -> 2019-07-31] is followed by [2019-08-01 -> 2019-08-12]
+	 * Note than in this example, isFollowedBy() would be false if 2019-08-01 or 2019-07-31 was excluded by options.
+	 *
+	 * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
+	 *
+	 * @return bool
+	 */
+	public function isFollowedBy($period, ...$arguments): bool
+	{
+		$period = $this->resolveCarbonPeriod($period, ...$arguments);
+
+		return $period->follows($this);
+	}
+
+	/**
+	 * Return true if the given period either follows or is followed by the current one.
+	 *
+	 * @see follows()
+	 * @see isFollowedBy()
+	 *
+	 * @param \Carbon\CarbonPeriod|\DatePeriod|string $period
+	 *
+	 * @return bool
+	 */
+	public function isConsecutiveWith($period, ...$arguments): bool
+	{
+		return $this->follows($period, ...$arguments) || $this->isFollowedBy($period, ...$arguments);
+	}
+
+	/**
+	 * Update properties after removing built-in filters.
+	 *
+	 * @return void
+	 */
+	protected function updateInternalState()
+	{
+		if (!$this->hasFilter(static::END_DATE_FILTER)) {
+			$this->endDate = null;
+		}
+
+		if (!$this->hasFilter(static::RECURRENCES_FILTER)) {
+			$this->recurrences = null;
+		}
+	}
+
+	/**
+	 * Create a filter tuple from raw parameters.
+	 *
+	 * Will create an automatic filter callback for one of Carbon's is* methods.
+	 *
+	 * @param array $parameters
+	 *
+	 * @return array
+	 */
+	protected function createFilterTuple(array $parameters)
+	{
+		$method = array_shift($parameters);
+
+		if (!$this->isCarbonPredicateMethod($method)) {
+			return [$method, array_shift($parameters)];
+		}
+
+		return [function ($date) use ($method, $parameters) {
+			return ([$date, $method])(...$parameters);
+		}, $method];
+	}
+
+	/**
+	 * Return whether given callable is a string pointing to one of Carbon's is* methods
+	 * and should be automatically converted to a filter callback.
+	 *
+	 * @param callable $callable
+	 *
+	 * @return bool
+	 */
+	protected function isCarbonPredicateMethod($callable)
+	{
+		return \is_string($callable) && str_starts_with($callable, 'is') &&
+			(method_exists($this->dateClass, $callable) || ([$this->dateClass, 'hasMacro'])($callable));
+	}
+
+	/**
+	 * Recurrences filter callback (limits number of recurrences).
+	 *
+	 * @SuppressWarnings(PHPMD.UnusedFormalParameter)
+	 *
+	 * @param \Carbon\Carbon $current
+	 * @param int            $key
+	 *
+	 * @return bool|string
+	 */
+	protected function filterRecurrences($current, $key)
+	{
+		if ($key < $this->recurrences) {
+			return true;
+		}
+
+		return static::END_ITERATION;
+	}
+
+	/**
+	 * End date filter callback.
+	 *
+	 * @param \Carbon\Carbon $current
+	 *
+	 * @return bool|string
+	 */
+	protected function filterEndDate($current)
+	{
+		if (!$this->isEndExcluded() && $current == $this->endDate) {
+			return true;
+		}
+
+		if ($this->dateInterval->invert ? $current > $this->endDate : $current < $this->endDate) {
+			return true;
+		}
+
+		return static::END_ITERATION;
+	}
+
+	/**
+	 * End iteration filter callback.
+	 *
+	 * @return string
+	 */
+	protected function endIteration()
+	{
+		return static::END_ITERATION;
+	}
+
+	/**
+	 * Handle change of the parameters.
+	 */
+	protected function handleChangedParameters()
+	{
+		if (($this->getOptions() & static::IMMUTABLE) && $this->dateClass === Carbon::class) {
+			$this->setDateClass(CarbonImmutable::class);
+		} elseif (!($this->getOptions() & static::IMMUTABLE) && $this->dateClass === CarbonImmutable::class) {
+			$this->setDateClass(Carbon::class);
+		}
+
+		$this->validationResult = null;
+	}
+
+	/**
+	 * Validate current date and stop iteration when necessary.
+	 *
+	 * Returns true when current date is valid, false if it is not, or static::END_ITERATION
+	 * when iteration should be stopped.
+	 *
+	 * @return bool|string
+	 */
+	protected function validateCurrentDate()
+	{
+		if ($this->current === null) {
+			$this->rewind();
+		}
+
+		// Check after the first rewind to avoid repeating the initial validation.
+		return $this->validationResult ?? ($this->validationResult = $this->checkFilters());
+	}
+
+	/**
+	 * Check whether current value and key pass all the filters.
+	 *
+	 * @return bool|string
+	 */
+	protected function checkFilters()
+	{
+		$current = $this->prepareForReturn($this->current);
+
+		foreach ($this->filters as $tuple) {
+			$result = \call_user_func(
+				$tuple[0],
+				$current->avoidMutation(),
+				$this->key,
+				$this
+			);
+
+			if ($result === static::END_ITERATION) {
+				return static::END_ITERATION;
+			}
+
+			if (!$result) {
+				return false;
+			}
+		}
+
+		return true;
+	}
+
+	/**
+	 * Prepare given date to be returned to the external logic.
+	 *
+	 * @param CarbonInterface $date
+	 *
+	 * @return CarbonInterface
+	 */
+	protected function prepareForReturn(CarbonInterface $date)
+	{
+		$date = ([$this->dateClass, 'make'])($date);
+
+		if ($this->timezone) {
+			$date = $date->setTimezone($this->timezone);
+		}
+
+		return $date;
+	}
+
+	/**
+	 * Keep incrementing the current date until a valid date is found or the iteration is ended.
+	 *
+	 * @throws RuntimeException
+	 *
+	 * @return void
+	 */
+	protected function incrementCurrentDateUntilValid()
+	{
+		$attempts = 0;
+
+		do {
+			$this->current = $this->current->add($this->dateInterval);
+
+			$this->validationResult = null;
+
+			if (++$attempts > static::NEXT_MAX_ATTEMPTS) {
+				throw new UnreachableException('Could not find next valid date.');
+			}
+		} while ($this->validateCurrentDate() === false);
+	}
+
+	/**
+	 * Call given macro.
+	 *
+	 * @param string $name
+	 * @param array  $parameters
+	 *
+	 * @return mixed
+	 */
+	protected function callMacro($name, $parameters)
+	{
+		$macro = static::$macros[$name];
+
+		if ($macro instanceof Closure) {
+			$boundMacro = @$macro->bindTo($this, static::class) ?: @$macro->bindTo(null, static::class);
+
+			return ($boundMacro ?: $macro)(...$parameters);
+		}
+
+		return $macro(...$parameters);
+	}
+
+	/**
+	 * Return the Carbon instance passed through, a now instance in the same timezone
+	 * if null given or parse the input if string given.
+	 *
+	 * @param \Carbon\Carbon|\Carbon\CarbonPeriod|\Carbon\CarbonInterval|\DateInterval|\DatePeriod|\DateTimeInterface|string|null $date
+	 *
+	 * @return \Carbon\CarbonInterface
+	 */
+	protected function resolveCarbon($date = null)
+	{
+		return $this->getStartDate()->nowWithSameTz()->carbonize($date);
+	}
+
+	/**
+	 * Resolve passed arguments or DatePeriod to a CarbonPeriod object.
+	 *
+	 * @param mixed $period
+	 * @param mixed ...$arguments
+	 *
+	 * @return static
+	 */
+	protected function resolveCarbonPeriod($period, ...$arguments)
+	{
+		if ($period instanceof self) {
+			return $period;
+		}
+
+		return $period instanceof DatePeriod
+			? static::instance($period)
+			: static::create($period, ...$arguments);
+	}
+
+	private function orderCouple($first, $second): array
+	{
+		return $first > $second ? [$second, $first] : [$first, $second];
+	}
+
+	private function makeDateTime($value): ?DateTimeInterface
+	{
+		if ($value instanceof DateTimeInterface) {
+			return $value;
+		}
+
+		if (\is_string($value)) {
+			$value = trim($value);
+
+			if (!preg_match('/^P[\dT]/', $value) &&
+				!preg_match('/^R\d/', $value) &&
+				preg_match('/[a-z\d]/i', $value)
+			) {
+				return Carbon::parse($value, $this->tzName);
+			}
+		}
+
+		return null;
+	}
+
+	private function isInfiniteDate($date): bool
+	{
+		return $date instanceof CarbonInterface && ($date->isEndOfTime() || $date->isStartOfTime());
+	}
+
+	private function rawDate($date): ?DateTimeInterface
+	{
+		if ($date === false || $date === null) {
+			return null;
+		}
+
+		if ($date instanceof CarbonInterface) {
+			return $date->isMutable()
+				? $date->toDateTime()
+				: $date->toDateTimeImmutable();
+		}
+
+		if (\in_array(\get_class($date), [DateTime::class, DateTimeImmutable::class], true)) {
+			return $date;
+		}
+
+		$class = $date instanceof DateTime ? DateTime::class : DateTimeImmutable::class;
+
+		return new $class($date->format('Y-m-d H:i:s.u'), $date->getTimezone());
+	}
 }

Spacing +6 added lines, -7 removed lines

@@ -606,7 +606,7 @@ 
         $date = new static();
 
         if (static::hasMacro($method)) {
-            return static::bindMacroContext(null, function () use (&$method, &$parameters, &$date) {
+            return static::bindMacroContext(null, function() use (&$method, &$parameters, &$date) {
                 return $date->callMacro($method, $parameters);
             });
         }
@@ -931,8 +931,7 @@ 
 
         return $this->setOptions(
             $state ?
-            $this->options | $options :
-            $this->options & ~$options
+            $this->options | $options : $this->options & ~$options
         );
     }
 
@@ -1144,7 +1143,7 @@ 
 
         $this->filters = array_values(array_filter(
             $this->filters,
-            function ($tuple) use ($key, $filter) {
+            function($tuple) use ($key, $filter) {
                 return $tuple[$key] !== $filter;
             }
         ));
@@ -1664,7 +1663,7 @@ 
     public function __call($method, $parameters)
     {
         if (static::hasMacro($method)) {
-            return static::bindMacroContext($this, function () use (&$method, &$parameters) {
+            return static::bindMacroContext($this, function() use (&$method, &$parameters) {
                 return $this->callMacro($method, $parameters);
             });
         }
@@ -1914,7 +1913,7 @@ 
      *
      * @param callable $callback
      */
-    public function forEach(callable $callback)
+    public function forEach (callable $callback)
     {
         foreach ($this as $date) {
             $callback($date);
@@ -2368,7 +2367,7 @@ 
             return [$method, array_shift($parameters)];
         }
 
-        return [function ($date) use ($method, $parameters) {
+        return [function($date) use ($method, $parameters) {
             return ([$date, $method])(...$parameters);
         }, $method];
     }

Upper-Lower-Casing +1 added lines, -1 removed lines

@@ -1914,7 +1914,7 @@
      *
      * @param callable $callback
      */
-    public function forEach(callable $callback)
+    public function foreach(callable $callback)
     {
         foreach ($this as $date) {
             $callback($date);

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Exceptions/EndLessPeriodException.php

Indentation +1 added lines, -1 removed lines

@@ -15,5 +15,5 @@
 
 final class EndLessPeriodException extends BaseRuntimeException implements RuntimeException
 {
-    //
+	//
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Exceptions/InvalidIntervalException.php

Indentation +1 added lines, -1 removed lines

@@ -15,5 +15,5 @@
 
 class InvalidIntervalException extends BaseInvalidArgumentException implements InvalidArgumentException
 {
-    //
+	//
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Exceptions/ImmutableException.php

Indentation +27 added lines, -27 removed lines

@@ -16,33 +16,33 @@
 
 class ImmutableException extends BaseRuntimeException implements RuntimeException
 {
-    /**
-     * The value.
-     *
-     * @var string
-     */
-    protected $value;
+	/**
+	 * The value.
+	 *
+	 * @var string
+	 */
+	protected $value;
 
-    /**
-     * Constructor.
-     *
-     * @param string         $value    the immutable type/value
-     * @param int            $code
-     * @param Throwable|null $previous
-     */
-    public function __construct($value, $code = 0, Throwable $previous = null)
-    {
-        $this->value = $value;
-        parent::__construct("$value is immutable.", $code, $previous);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string         $value    the immutable type/value
+	 * @param int            $code
+	 * @param Throwable|null $previous
+	 */
+	public function __construct($value, $code = 0, Throwable $previous = null)
+	{
+		$this->value = $value;
+		parent::__construct("$value is immutable.", $code, $previous);
+	}
 
-    /**
-     * Get the value.
-     *
-     * @return string
-     */
-    public function getValue(): string
-    {
-        return $this->value;
-    }
+	/**
+	 * Get the value.
+	 *
+	 * @return string
+	 */
+	public function getValue(): string
+	{
+		return $this->value;
+	}
 }

htdocs/includes/webklex/php-imap/vendor/nesbot/carbon/src/Carbon/Exceptions/InvalidDateException.php

Indentation +44 added lines, -44 removed lines

@@ -16,52 +16,52 @@
 
 class InvalidDateException extends BaseInvalidArgumentException implements InvalidArgumentException
 {
-    /**
-     * The invalid field.
-     *
-     * @var string
-     */
-    private $field;
+	/**
+	 * The invalid field.
+	 *
+	 * @var string
+	 */
+	private $field;
 
-    /**
-     * The invalid value.
-     *
-     * @var mixed
-     */
-    private $value;
+	/**
+	 * The invalid value.
+	 *
+	 * @var mixed
+	 */
+	private $value;
 
-    /**
-     * Constructor.
-     *
-     * @param string         $field
-     * @param mixed          $value
-     * @param int            $code
-     * @param Throwable|null $previous
-     */
-    public function __construct($field, $value, $code = 0, Throwable $previous = null)
-    {
-        $this->field = $field;
-        $this->value = $value;
-        parent::__construct($field.' : '.$value.' is not a valid value.', $code, $previous);
-    }
+	/**
+	 * Constructor.
+	 *
+	 * @param string         $field
+	 * @param mixed          $value
+	 * @param int            $code
+	 * @param Throwable|null $previous
+	 */
+	public function __construct($field, $value, $code = 0, Throwable $previous = null)
+	{
+		$this->field = $field;
+		$this->value = $value;
+		parent::__construct($field.' : '.$value.' is not a valid value.', $code, $previous);
+	}
 
-    /**
-     * Get the invalid field.
-     *
-     * @return string
-     */
-    public function getField()
-    {
-        return $this->field;
-    }
+	/**
+	 * Get the invalid field.
+	 *
+	 * @return string
+	 */
+	public function getField()
+	{
+		return $this->field;
+	}
 
-    /**
-     * Get the invalid value.
-     *
-     * @return mixed
-     */
-    public function getValue()
-    {
-        return $this->value;
-    }
+	/**
+	 * Get the invalid value.
+	 *
+	 * @return mixed
+	 */
+	public function getValue()
+	{
+		return $this->value;
+	}
 }