X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FUtil%2FDateTimeFormat.php;h=41cd16d2f41464bc692a63963b6109ba1e37dee1;hb=4e45987f74ccbe61a53c711317c2e45894435ece;hp=b039ff80a170c4fc504e9f6ac95420ceff7b218c;hpb=dad58e0f6fdff5e1ff8a002bb31119a38f08268b;p=friendica.git diff --git a/src/Util/DateTimeFormat.php b/src/Util/DateTimeFormat.php index b039ff80a1..41cd16d2f4 100644 --- a/src/Util/DateTimeFormat.php +++ b/src/Util/DateTimeFormat.php @@ -1,22 +1,48 @@ . + * */ namespace Friendica\Util; +use Friendica\Core\Logger; use DateTime; 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 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. @@ -24,8 +50,9 @@ class DateTimeFormat * @param string $time A date/time string * @param string $format DateTime format string or Temporal constant * @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); } @@ -36,17 +63,20 @@ class DateTimeFormat * @param string $time A date/time string * @param string $format DateTime format string or Temporal constant * @return string + * @throws Exception */ 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); } /** * convert() shorthand for timezoned now. * + * @param $timezone * @param string $format DateTime format string or Temporal constant * @return string + * @throws Exception */ public static function timezoneNow($timezone, $format = self::MYSQL) { @@ -58,6 +88,7 @@ class DateTimeFormat * * @param string $format DateTime format string or Temporal constant * @return string + * @throws Exception */ public static function localNow($format = self::MYSQL) { @@ -69,33 +100,35 @@ class DateTimeFormat * * @param string $format DateTime format string or Temporal constant * @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 * @param string $tz_from Source timezone * @param string $format Output format recognised from php's DateTime class - * http://www.php.net/manual/en/datetime.format.php + * http://www.php.net/manual/en/datetime.format.php * * @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) { // Defaults to UTC if nothing is set, but throws an exception if set to empty string. // Provide some sane defaults regardless. - if ($from === '') { - $from = 'UTC'; + if ($tz_from === '') { + $tz_from = 'UTC'; } - if ($to === '') { - $to = 'UTC'; + if ($tz_to === '') { + $tz_to = 'UTC'; } if (($s === '') || (!is_string($s))) { @@ -109,6 +142,9 @@ class DateTimeFormat * months and days always start with 1. */ 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)); } @@ -122,7 +158,7 @@ class DateTimeFormat try { $d = new DateTime($s, $from_obj); } catch (Exception $e) { - logger('DateTimeFormat::convert: exception: ' . $e->getMessage()); + Logger::notice('DateTimeFormat::convert: exception: ' . $e->getMessage()); $d = new DateTime('now', $from_obj); } @@ -132,8 +168,62 @@ class DateTimeFormat $to_obj = new DateTimeZone('UTC'); } - $d->setTimeZone($to_obj); + $d->setTimezone($to_obj); return $d->format($format); } + + /** + * 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; + } }