X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=src%2FUtil%2FDateTimeFormat.php;h=e29420e9ea41c272dcbbb63868bc0ffac6972b0a;hb=4b44aca50735dc047e495825bff7dfa717acb615;hp=8545cd07c43668ac938e16feff57135ebc425a31;hpb=2f28c2ebbfd8f66093d7081d40b1d48f65fcff20;p=friendica.git

diff --git a/src/Util/DateTimeFormat.php b/src/Util/DateTimeFormat.php
index 8545cd07c4..e29420e9ea 100644
--- a/src/Util/DateTimeFormat.php
+++ b/src/Util/DateTimeFormat.php
@@ -18,6 +18,7 @@ class DateTimeFormat
 {
 	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';
 
 	/**
 	 * convert() shorthand for UTC.
@@ -25,6 +26,7 @@ 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)
 	{
@@ -37,6 +39,7 @@ 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)
 	{
@@ -46,8 +49,10 @@ class DateTimeFormat
 	/**
 	 * 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)
 	{
@@ -59,6 +64,7 @@ class DateTimeFormat
 	 *
 	 * @param string $format DateTime format string or Temporal constant
 	 * @return string
+	 * @throws Exception
 	 */
 	public static function localNow($format = self::MYSQL)
 	{
@@ -70,6 +76,7 @@ class DateTimeFormat
 	 *
 	 * @param string $format DateTime format string or Temporal constant
 	 * @return string
+	 * @throws Exception
 	 */
 	public static function utcNow($format = self::MYSQL)
 	{
@@ -83,9 +90,10 @@ class DateTimeFormat
 	 * @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)
 	{
@@ -140,4 +148,37 @@ class DateTimeFormat
 
 		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;
+	}
 }