<?php
declare(strict_types=1);
namespace Kreait\Firebase\Util;
use DateTimeImmutable;
use DateTimeInterface;
use DateTimeZone;
use Kreait\Firebase\Exception\InvalidArgumentException;
use Throwable;
use function ctype_digit;
use function get_debug_type;
use function is_bool;
use function is_object;
use function is_scalar;
use function mb_strlen;
use function method_exists;
use function preg_match;
use function sprintf;
use function time;
/**
* @internal
*/
final class DT
{
public static function toUTCDateTimeImmutable(mixed $value): DateTimeImmutable
{
$tz = new DateTimeZone('UTC');
$now = time();
if (
($value instanceof DateTimeInterface)
&& $result = DateTimeImmutable::createFromFormat('U.u', $value->format('U.u'))
) {
return $result->setTimezone($tz);
}
if ($value === null || $value === 0 || is_bool($value)) {
$value = '0';
}
if (is_scalar($value) || (is_object($value) && method_exists($value, '__toString'))) {
$value = (string) $value;
} else {
$type = get_debug_type($value);
throw new InvalidArgumentException("This {$type} cannot be parsed to a DateTime value");
}
if (ctype_digit($value)) {
// Seconds
if (($value === '0' || mb_strlen($value) === mb_strlen((string) $now)) && ($result = DateTimeImmutable::createFromFormat('U', $value))) {
return $result->setTimezone($tz);
}
// Milliseconds
if (mb_strlen($value) === mb_strlen((string) ($now * 1000))) {
$floatValue = (float) $value;
$result = DateTimeImmutable::createFromFormat('U.u', sprintf('%F', $floatValue / 1000));
if ($result !== false) {
return $result->setTimezone($tz);
}
}
}
// microtime
if (preg_match('@(?P<msec>^0?\.\d+) (?P<sec>\d+)$@', $value, $matches)) {
$value = (string) ((float) $matches['sec'] + (float) $matches['msec']);
if ($result = DateTimeImmutable::createFromFormat('U.u', sprintf('%F', $value))) {
return $result->setTimezone($tz);
}
}
try {
return (new DateTimeImmutable($value))->setTimezone($tz);
} catch (Throwable $e) {
throw new InvalidArgumentException($e->getMessage());
}
}
}