[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * This file is part of the ramsey/uuid library
   4   *
   5   * For the full copyright and license information, please view the LICENSE
   6   * file that was distributed with this source code.
   7   *
   8   * @copyright Copyright (c) Ben Ramsey <[email protected]>
   9   * @license http://opensource.org/licenses/MIT MIT
  10   * @link https://benramsey.com/projects/ramsey-uuid/ Documentation
  11   * @link https://packagist.org/packages/ramsey/uuid Packagist
  12   * @link https://github.com/ramsey/uuid GitHub
  13   */
  14  
  15  namespace Ramsey\Uuid\Converter;
  16  
  17  use Ramsey\Uuid\Exception\UnsatisfiedDependencyException;
  18  
  19  /**
  20   * TimeConverterInterface provides facilities for converting parts of time into
  21   * representations that may be used in UUIDs
  22   */
  23  interface TimeConverterInterface
  24  {
  25      /**
  26       * Uses the provided seconds and micro-seconds to calculate the time_low,
  27       * time_mid, and time_high fields used by RFC 4122 version 1 UUIDs
  28       *
  29       * @param string $seconds
  30       * @param string $microSeconds
  31       * @return string[] An array guaranteed to contain `low`, `mid`, and `hi` keys
  32       * @throws UnsatisfiedDependencyException if called on a 32-bit system and
  33       *     `Moontoast\Math\BigNumber` is not present
  34       * @link http://tools.ietf.org/html/rfc4122#section-4.2.2
  35       */
  36      public function calculateTime($seconds, $microSeconds);
  37  }