uuid_functions.php

<?php

declare(strict_types=1);

namespace Infrastructure\Uuid;

use Ramsey\Uuid\Nonstandard\UuidV6;
use Ramsey\Uuid\Rfc4122\UuidV1;
use Ramsey\Uuid\Uuid;

/**
 * @psalm-pure
 */
function extractUuidTime(string $uuid): \DateTimeImmutable
{
    $uuid = Uuid::fromString($uuid);

    if (!$uuid instanceof UuidV1 && !$uuid instanceof UuidV6) {
        throw new \InvalidArgumentException('Given string is not a time-based UUID.');
    }

    return $uuid->getDateTime();
}

/**
 * @psalm-pure
 */
function extractUuidMicroseconds(string $uuid): string
{
    return extractUuidTime($uuid)->format('Uu');
}