Debian Codegraph @

vendor/ramsey/uuid/src/Converter/TimeConverterInterface.php

raw
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 }