| 1 |
<?php |
| 2 |
|
| 3 |
namespace Dudlewebs\WPMCS\s3\Aws\Api; |
| 4 |
|
| 5 |
use Dudlewebs\WPMCS\s3\Aws\Api\Parser\Exception\ParserException; |
| 6 |
use DateTime; |
| 7 |
use DateTimeZone; |
| 8 |
use Exception; |
| 9 |
/** |
| 10 |
* DateTime overrides that make DateTime work more seamlessly as a string, |
| 11 |
* with JSON documents, and with JMESPath. |
| 12 |
*/ |
| 13 |
class DateTimeResult extends \DateTime implements \JsonSerializable |
| 14 |
{ |
| 15 |
/** |
| 16 |
* Create a new DateTimeResult from a unix timestamp. |
| 17 |
* The Unix epoch (or Unix time or POSIX time or Unix |
| 18 |
* timestamp) is the number of seconds that have elapsed since |
| 19 |
* January 1, 1970 (midnight UTC/GMT). |
| 20 |
* |
| 21 |
* @return DateTimeResult |
| 22 |
* @throws Exception |
| 23 |
*/ |
| 24 |
public static function fromEpoch($unixTimestamp) |
| 25 |
{ |
| 26 |
if (!\is_numeric($unixTimestamp)) { |
| 27 |
throw new ParserException('Invalid timestamp value passed to DateTimeResult::fromEpoch'); |
| 28 |
} |
| 29 |
// PHP 5.5 does not support sub-second precision |
| 30 |
if (\PHP_VERSION_ID < 56000) { |
| 31 |
return new self(\gmdate('c', $unixTimestamp)); |
| 32 |
} |
| 33 |
$decimalSeparator = isset(\localeconv()['decimal_point']) ? \localeconv()['decimal_point'] : "."; |
| 34 |
$formatString = "U" . $decimalSeparator . "u"; |
| 35 |
$dateTime = DateTime::createFromFormat($formatString, \sprintf('%0.6f', $unixTimestamp), new DateTimeZone('UTC')); |
| 36 |
if (\false === $dateTime) { |
| 37 |
throw new ParserException('Invalid timestamp value passed to DateTimeResult::fromEpoch'); |
| 38 |
} |
| 39 |
return new self($dateTime->format('Y-m-d H:i:s.u'), new DateTimeZone('UTC')); |
| 40 |
} |
| 41 |
/** |
| 42 |
* @return DateTimeResult |
| 43 |
*/ |
| 44 |
public static function fromISO8601($iso8601Timestamp) |
| 45 |
{ |
| 46 |
if (\is_numeric($iso8601Timestamp) || !\is_string($iso8601Timestamp)) { |
| 47 |
throw new ParserException('Invalid timestamp value passed to DateTimeResult::fromISO8601'); |
| 48 |
} |
| 49 |
return new DateTimeResult($iso8601Timestamp); |
| 50 |
} |
| 51 |
/** |
| 52 |
* Create a new DateTimeResult from an unknown timestamp. |
| 53 |
* |
| 54 |
* @return DateTimeResult |
| 55 |
* @throws Exception |
| 56 |
*/ |
| 57 |
public static function fromTimestamp($timestamp, $expectedFormat = null) |
| 58 |
{ |
| 59 |
if (empty($timestamp)) { |
| 60 |
return self::fromEpoch(0); |
| 61 |
} |
| 62 |
if (!(\is_string($timestamp) || \is_numeric($timestamp))) { |
| 63 |
throw new ParserException('Invalid timestamp value passed to DateTimeResult::fromTimestamp'); |
| 64 |
} |
| 65 |
try { |
| 66 |
if ($expectedFormat == 'iso8601') { |
| 67 |
try { |
| 68 |
return self::fromISO8601($timestamp); |
| 69 |
} catch (Exception $exception) { |
| 70 |
return self::fromEpoch($timestamp); |
| 71 |
} |
| 72 |
} else { |
| 73 |
if ($expectedFormat == 'unixTimestamp') { |
| 74 |
try { |
| 75 |
return self::fromEpoch($timestamp); |
| 76 |
} catch (Exception $exception) { |
| 77 |
return self::fromISO8601($timestamp); |
| 78 |
} |
| 79 |
} else { |
| 80 |
if (\Dudlewebs\WPMCS\s3\Aws\is_valid_epoch($timestamp)) { |
| 81 |
return self::fromEpoch($timestamp); |
| 82 |
} |
| 83 |
} |
| 84 |
} |
| 85 |
return self::fromISO8601($timestamp); |
| 86 |
} catch (Exception $exception) { |
| 87 |
throw new ParserException('Invalid timestamp value passed to DateTimeResult::fromTimestamp'); |
| 88 |
} |
| 89 |
} |
| 90 |
/** |
| 91 |
* Serialize the DateTimeResult as an ISO 8601 date string. |
| 92 |
* |
| 93 |
* @return string |
| 94 |
*/ |
| 95 |
public function __toString() |
| 96 |
{ |
| 97 |
return $this->format('c'); |
| 98 |
} |
| 99 |
/** |
| 100 |
* Serialize the date as an ISO 8601 date when serializing as JSON. |
| 101 |
* |
| 102 |
* @return string |
| 103 |
*/ |
| 104 |
#[\ReturnTypeWillChange] |
| 105 |
public function jsonSerialize() |
| 106 |
{ |
| 107 |
return (string) $this; |
| 108 |
} |
| 109 |
} |
| 110 |
|
