PHP 8.2.30
Preview: Duration.php Size: 3.45 KB
/home/byroehnu/easetack.com/vendor/phpunit/phpunit/src/Event/Value/Telemetry/Duration.php

<?php declare(strict_types=1);
/*
 * This file is part of PHPUnit.
 *
 * (c) Sebastian Bergmann <sebastian@phpunit.de>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */
namespace PHPUnit\Event\Telemetry;

use function floor;
use function sprintf;
use PHPUnit\Event\InvalidArgumentException;

/**
 * @immutable
 *
 * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
 */
final readonly class Duration
{
    private int $seconds;
    private 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.',
            );
        }
    }
}

Directory Contents

Dirs: 0 × Files: 15

Name Size Perms Modified Actions
3.45 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
4.58 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
597 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
2.52 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
2.27 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
625 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
864 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
1.04 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
1.60 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
1.38 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
561 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
1.30 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
882 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
791 B lrw-rw-rw- 2025-04-08 07:59:11
Edit Download
1.07 KB lrw-rw-rw- 2025-04-08 07:59:11
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).