<?php

/*

* This file is part of the Symfony package.

*

* (c) Fabien Potencier <[email protected]>

*

* For the full copyright and license information, please view the LICENSE

* file that was distributed with this source code.

*/

namespace Symfony\Component\Stopwatch;

/**

* Represents a Period for an Event.

*

* @author Fabien Potencier <[email protected]>

*/

class StopwatchPeriod

{

private int|float $start;

private int|float $end;

private int $memory;

/**

* @param int|float $start The relative time of the start of the period (in milliseconds)

* @param int|float $end The relative time of the end of the period (in milliseconds)

* @param bool $morePrecision If true, time is stored as float to keep the original microsecond precision

*/

public function __construct(int|float $start, int|float $end, bool $morePrecision = false)

{

$this->start = $morePrecision ? (float) $start : (int) $start;

$this->end = $morePrecision ? (float) $end : (int) $end;

$this->memory = memory_get_usage(true);

}

/**

* Gets the relative time of the start of the period in milliseconds.

*/

public function getStartTime(): int|float

{

return $this->start;

}

/**

* Gets the relative time of the end of the period in milliseconds.

*/

public function getEndTime(): int|float

{

return $this->end;

}

/**

* Gets the time spent in this period in milliseconds.

*/

public function getDuration(): int|float

{

return $this->end - $this->start;

}

/**

* Gets the memory usage in bytes.

*/

public function getMemory(): int

{

return $this->memory;

}

public function __toString(): string

{

return \sprintf('%.2F MiB - %d ms', $this->getMemory() / 1024 / 1024, $this->getDuration());

}

}