class Duration

Same name in this branch

11.1.x vendor/phpunit/php-timer/src/Duration.php \SebastianBergmann\Timer\Duration
11.1.x vendor/google/protobuf/src/Google/Protobuf/Duration.php \Google\Protobuf\Duration
11.1.x vendor/google/protobuf/src/GPBMetadata/Google/Protobuf/Duration.php \GPBMetadata\Google\Protobuf\Duration

@psalm-immutable

@no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit

Hierarchy

class \PHPUnit\Event\Telemetry\Duration

Expanded class hierarchy of Duration

2 string references to 'Duration'

Builder::fromParameters in vendor/phpunit/phpunit/src/TextUI/Configuration/Cli/Builder.php
Loader::phpunit in vendor/phpunit/phpunit/src/TextUI/Configuration/Xml/Loader.php

File

vendor/phpunit/phpunit/src/Event/Value/Telemetry/Duration.php, line 21

Namespace

PHPUnit\Event\Telemetry

View source

final class Duration {
    private readonly int $seconds;
    private readonly int $nanoseconds;
    
    /**
     * @throws InvalidArgumentException
     */
    public static function fromSecondsAndNanoseconds(int $seconds, int $nanoseconds) : self {
        return new self($seconds, $nanoseconds);
    }
    
    /**
     * @throws InvalidArgumentException
     */
    private function __construct(int $seconds, int $nanoseconds) {
        $this->ensureNotNegative($seconds, 'seconds');
        $this->ensureNotNegative($nanoseconds, 'nanoseconds');
        $this->ensureNanoSecondsInRange($nanoseconds);
        $this->seconds = $seconds;
        $this->nanoseconds = $nanoseconds;
    }
    public function seconds() : int {
        return $this->seconds;
    }
    public function nanoseconds() : int {
        return $this->nanoseconds;
    }
    public function asFloat() : float {
        return $this->seconds() + $this->nanoseconds() / 1000000000;
    }
    public function asString() : string {
        $seconds = $this->seconds();
        $minutes = 0;
        $hours = 0;
        if ($seconds > 60 * 60) {
            $hours = floor($seconds / 60 / 60);
            $seconds -= $hours * 60 * 60;
        }
        if ($seconds > 60) {
            $minutes = floor($seconds / 60);
            $seconds -= $minutes * 60;
        }
        return sprintf('%02d:%02d:%02d.%09d', $hours, $minutes, $seconds, $this->nanoseconds());
    }
    public function equals(self $other) : bool {
        return $this->seconds === $other->seconds && $this->nanoseconds === $other->nanoseconds;
    }
    public function isLessThan(self $other) : bool {
        if ($this->seconds < $other->seconds) {
            return true;
        }
        if ($this->seconds > $other->seconds) {
            return false;
        }
        return $this->nanoseconds < $other->nanoseconds;
    }
    public function isGreaterThan(self $other) : bool {
        if ($this->seconds > $other->seconds) {
            return true;
        }
        if ($this->seconds < $other->seconds) {
            return false;
        }
        return $this->nanoseconds > $other->nanoseconds;
    }
    
    /**
     * @throws InvalidArgumentException
     */
    private function ensureNotNegative(int $value, string $type) : void {
        if ($value < 0) {
            throw new InvalidArgumentException(sprintf('Value for %s must not be negative.', $type));
        }
    }
    
    /**
     * @throws InvalidArgumentException
     */
    private function ensureNanoSecondsInRange(int $nanoseconds) : void {
        if ($nanoseconds > 999999999) {
            throw new InvalidArgumentException('Value for nanoseconds must not be greater than 999999999.');
        }
    }

}

Members

Title Sort descending	Modifiers	Object type
Duration::$nanoseconds	private	property
Duration::$seconds	private	property
Duration::asFloat	public	function
Duration::asString	public	function
Duration::ensureNanoSecondsInRange	private	function
Duration::ensureNotNegative	private	function
Duration::equals	public	function
Duration::fromSecondsAndNanoseconds	public static	function
Duration::isGreaterThan	public	function
Duration::isLessThan	public	function
Duration::nanoseconds	public	function
Duration::seconds	public	function
Duration::__construct	private	function