media-cloud-sync / includes / sdk / google / ramsey / uuid / src / Converter / TimeConverterInterface.php

TimeConverterInterface.php in Media Cloud Sync 1.2.8, at includes/sdk/google/ramsey/uuid/src/Converter/TimeConverterInterface.php

55 lines 1.8 KB

Raw Download Zip

1	<?php
2
3	/**
4	* This file is part of the ramsey/uuid library
5	*
6	* For the full copyright and license information, please view the LICENSE
7	* file that was distributed with this source code.
8	*
9	* @copyright Copyright (c) Ben Ramsey <[email protected]>
10	* @license http://opensource.org/licenses/MIT MIT
11	*/
12	declare (strict_types=1);
13	namespace Dudlewebs\WPMCS\Ramsey\Uuid\Converter;
14
15	use Dudlewebs\WPMCS\Ramsey\Uuid\Type\Hexadecimal;
16	use Dudlewebs\WPMCS\Ramsey\Uuid\Type\Time;
17	/**
18	* A time converter converts timestamps into representations that may be used
19	* in UUIDs
20	*
21	* @psalm-immutable
22	*/
23	interface TimeConverterInterface
24	{
25	/**
26	* Uses the provided seconds and micro-seconds to calculate the count of
27	* 100-nanosecond intervals since UTC 00:00:00.00, 15 October 1582, for
28	* RFC 4122 variant UUIDs
29	*
30	* @link http://tools.ietf.org/html/rfc4122#section-4.2.2 RFC 4122, § 4.2.2: Generation Details
31	*
32	* @param string $seconds A string representation of the number of seconds
33	* since the Unix epoch for the time to calculate
34	* @param string $microseconds A string representation of the micro-seconds
35	* associated with the time to calculate
36	*
37	* @return Hexadecimal The full UUID timestamp as a Hexadecimal value
38	*
39	* @psalm-pure
40	*/
41	public function calculateTime(string $seconds, string $microseconds): Hexadecimal;
42	/**
43	* Converts a timestamp extracted from a UUID to a Unix timestamp
44	*
45	* @param Hexadecimal $uuidTimestamp A hexadecimal representation of a UUID
46	* timestamp; a UUID timestamp is a count of 100-nanosecond intervals
47	* since UTC 00:00:00.00, 15 October 1582.
48	*
49	* @return Time An instance of {@see Time}
50	*
51	* @psalm-pure
52	*/
53	public function convertTime(Hexadecimal $uuidTimestamp): Time;
54	}
55