X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FUtil%2FDateTimeFormat.php;h=b413e80c57728b70ca16431c48ccb79c4a337d43;hb=3bca4fe2a64671d09e08346456cdfa6c12f996e9;hp=0b47a16f1549b5fa86c4417bc1bd6949c6684c5c;hpb=854cc3e47296d4a1b01b893376064cf254d84f79;p=friendica.git diff --git a/src/Util/DateTimeFormat.php b/src/Util/DateTimeFormat.php index 0b47a16f15..b413e80c57 100644 --- a/src/Util/DateTimeFormat.php +++ b/src/Util/DateTimeFormat.php @@ -1,7 +1,22 @@ . + * */ namespace Friendica\Util; @@ -12,13 +27,22 @@ use DateTimeZone; use Exception; /** - * @brief Temporal class + * Temporal class */ class DateTimeFormat { - const ATOM = 'Y-m-d\TH:i:s\Z'; + const ATOM = 'Y-m-d\TH:i:s\Z'; const MYSQL = 'Y-m-d H:i:s'; - const HTTP = 'D, d M Y H:i:s \G\M\T'; + const HTTP = 'D, d M Y H:i:s \G\M\T'; + const JSON = 'Y-m-d\TH:i:s.v\Z'; + const API = 'D M d H:i:s +0000 Y'; + + static $localTimezone = 'UTC'; + + public static function setLocalTimeZone(string $timezone) + { + self::$localTimezone = $timezone; + } /** * convert() shorthand for UTC. @@ -28,7 +52,7 @@ class DateTimeFormat * @return string * @throws Exception */ - public static function utc($time, $format = self::MYSQL) + public static function utc(string $time, string $format = self::MYSQL): string { return self::convert($time, 'UTC', 'UTC', $format); } @@ -43,7 +67,7 @@ class DateTimeFormat */ public static function local($time, $format = self::MYSQL) { - return self::convert($time, date_default_timezone_get(), 'UTC', $format); + return self::convert($time, self::$localTimezone, 'UTC', $format); } /** @@ -78,13 +102,13 @@ class DateTimeFormat * @return string * @throws Exception */ - public static function utcNow($format = self::MYSQL) + public static function utcNow(string $format = self::MYSQL): string { return self::utc('now', $format); } /** - * @brief General purpose date parse/convert/format function. + * General purpose date parse/convert/format function. * * @param string $s Some parseable date/time string * @param string $tz_to Destination timezone @@ -95,7 +119,7 @@ class DateTimeFormat * @return string Formatted date according to given format * @throws Exception */ - public static function convert($s = 'now', $tz_to = 'UTC', $tz_from = 'UTC', $format = self::MYSQL) + public static function convert(string $s = 'now', string $tz_to = 'UTC', string $tz_from = 'UTC', string $format = self::MYSQL): string { // Defaults to UTC if nothing is set, but throws an exception if set to empty string. // Provide some sane defaults regardless. @@ -111,18 +135,11 @@ class DateTimeFormat $s = 'now'; } - /* - * Slight hackish adjustment so that 'zero' datetime actually returns what is intended - * otherwise we end up with -0001-11-30 ... - * add 32 days so that we at least get year 00, and then hack around the fact that - * months and days always start with 1. - */ + // Lowest possible datetime value if (substr($s, 0, 10) <= '0001-01-01') { - if ($s < '0000-00-00') { - $s = '0000-00-00'; - } - $d = new DateTime($s . ' + 32 days', new DateTimeZone('UTC')); - return str_replace('1', '0', $d->format($format)); + $d = new DateTime('now', new DateTimeZone('UTC')); + $d->setDate(1, 1, 1)->setTime(0, 0); + return $d->format($format); } try { @@ -134,8 +151,12 @@ class DateTimeFormat try { $d = new DateTime($s, $from_obj); } catch (Exception $e) { - Logger::log('DateTimeFormat::convert: exception: ' . $e->getMessage()); - $d = new DateTime('now', $from_obj); + try { + $d = new DateTime(self::fix($s), $from_obj); + } catch (\Throwable $e) { + Logger::warning('DateTimeFormat::convert: exception: ' . $e->getMessage()); + $d = new DateTime('now', $from_obj); + } } try { @@ -144,8 +165,91 @@ class DateTimeFormat $to_obj = new DateTimeZone('UTC'); } - $d->setTimeZone($to_obj); + $d->setTimezone($to_obj); return $d->format($format); } + + /** + * Fix weird date formats. + * + * Note: This method isn't meant to sanitize valid date/time strings, for example it will mangle relative date + * strings like "now - 3 days". + * + * @see \Friendica\Test\src\Util\DateTimeFormatTest::dataFix() for a list of examples handled by this method. + * @param string $dateString + * @return string + */ + public static function fix(string $dateString): string + { + $search = ['Mär', 'März', 'Mai', 'Juni', 'Juli', 'Okt', 'Dez', 'ET' , 'ZZ', ' - ', '+', '&#43;', ' (Coordinated Universal Time)', '\\']; + $replace = ['Mar', 'Mar' , 'May', 'Jun' , 'Jul' , 'Oct', 'Dec', 'EST', 'Z' , ', ' , '+' , '+' , '' , '']; + + $dateString = str_replace($search, $replace, $dateString); + + $pregPatterns = [ + ['#(\w+), (\d+ \w+ \d+) (\d+:\d+:\d+) (.+)#', '$2 $3 $4'], + ['#(\d+:\d+) (\w+), (\w+) (\d+), (\d+)#', '$1 $2 $3 $4 $5'], + ]; + + foreach ($pregPatterns as $pattern) { + $dateString = preg_replace($pattern[0], $pattern[1], $dateString); + } + + return $dateString; + } + + /** + * Checks, if the given string is a date with the pattern YYYY-MM + * + * @param string $dateString The given date + * + * @return boolean True, if the date is a valid pattern + */ + public function isYearMonth(string $dateString) + { + // Check format (2019-01, 2019-1, 2019-10) + if (!preg_match('/^([12]\d{3}-(1[0-2]|0[1-9]|\d))$/', $dateString)) { + return false; + } + + $date = DateTime::createFromFormat('Y-m', $dateString); + + if (!$date) { + return false; + } + + try { + $now = new DateTime(); + } catch (\Throwable $t) { + return false; + } + + if ($date > $now) { + return false; + } + + return true; + } + + /** + * Checks, if the given string is a date with the pattern YYYY-MM-DD + * + * @param string $dateString The given date + * + * @return boolean True, if the date is a valid pattern + */ + public function isYearMonthDay(string $dateString) + { + $date = DateTime::createFromFormat('Y-m-d', $dateString); + if (!$date) { + return false; + } + + if (DateTime::getLastErrors()['error_count'] || DateTime::getLastErrors()['warning_count']) { + return false; + } + + return true; + } }