Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x

UnixTimeConverter.php

Namespace

Ramsey\Uuid\Converter\Time

File

vendor/ramsey/uuid/src/Converter/Time/UnixTimeConverter.php

View source
<?php


/**
 * This file is part of the ramsey/uuid library
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
 * @license http://opensource.org/licenses/MIT MIT
 */
declare (strict_types=1);
namespace Ramsey\Uuid\Converter\Time;

use Ramsey\Uuid\Converter\TimeConverterInterface;
use Ramsey\Uuid\Math\CalculatorInterface;
use Ramsey\Uuid\Math\RoundingMode;
use Ramsey\Uuid\Type\Hexadecimal;
use Ramsey\Uuid\Type\Integer as IntegerObject;
use Ramsey\Uuid\Type\Time;
use function explode;
use function str_pad;
use const STR_PAD_LEFT;

/**
 * UnixTimeConverter converts Unix Epoch timestamps to/from hexadecimal values
 * consisting of milliseconds elapsed since the Unix Epoch
 *
 * @psalm-immutable
 */
class UnixTimeConverter implements TimeConverterInterface {
    private const MILLISECONDS = 1000;
    public function __construct(CalculatorInterface $calculator) {
    }
    public function calculateTime(string $seconds, string $microseconds) : Hexadecimal {
        $timestamp = new Time($seconds, $microseconds);
        // Convert the seconds into milliseconds.
        $sec = $this->calculator
            ->multiply($timestamp->getSeconds(), new IntegerObject(self::MILLISECONDS));
        // Convert the microseconds into milliseconds; the scale is zero because
        // we need to discard the fractional part.
        $usec = $this->calculator
            ->divide(RoundingMode::DOWN, 0, $timestamp->getMicroseconds(), new IntegerObject(self::MILLISECONDS));
        
        /** @var IntegerObject $unixTime */
        $unixTime = $this->calculator
            ->add($sec, $usec);
        $unixTimeHex = str_pad($this->calculator
            ->toHexadecimal($unixTime)
            ->toString(), 12, '0', STR_PAD_LEFT);
        return new Hexadecimal($unixTimeHex);
    }
    public function convertTime(Hexadecimal $uuidTimestamp) : Time {
        $milliseconds = $this->calculator
            ->toInteger($uuidTimestamp);
        $unixTimestamp = $this->calculator
            ->divide(RoundingMode::HALF_UP, 6, $milliseconds, new IntegerObject(self::MILLISECONDS));
        $split = explode('.', (string) $unixTimestamp, 2);
        return new Time($split[0], $split[1] ?? '0');
    }

}

Classes

Title Deprecated Summary
UnixTimeConverter UnixTimeConverter converts Unix Epoch timestamps to/from hexadecimal values consisting of milliseconds elapsed since the Unix Epoch

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal