Deprecates legacy date conversion methods

Replaces legacy timestamp and date conversion methods with new, standardized alternatives (`fromTimestamp`, `fromDateTime`, `toDateTime`). Marks old methods as deprecated to encourage migration to the updated API.

Improves consistency and clarity in handling date and datetime conversions. Updates related deprecation notices for better guidance.

Author: Vitexus

src/AbraFlexi/Date.php

@@ -76,18 +76,37 @@ public function __toString(): string
     /**
      * Convert Timestamp to AbraFlexi Date format.
      *
+     * @deprecated message: Use Date::fromTimestamp() instead
+     *
      * @param int $timpestamp
      *
      * @return \AbraFlexi\Date or NULL
      */
     public static function timestampToFlexiDate($timpestamp = null): self
+    {
+        return self::fromTimestamp($timpestamp);
+    }
+
+    public static function fromTimestamp(int $timpestamp): self
     {
         $flexiDate = new self();
 
-        if (null !== $timpestamp) {
-            $flexiDate->setTimestamp($timpestamp);
-        }
+        $flexiDate->setTimestamp($timpestamp);
 
         return $flexiDate;
     }
+
+    public static function fromDateTime(\DateTime $when): self
+    {
+        return new self($when->format(self::$format));
+    }
+
+    public function toDateTime(): \DateTime
+    {
+        $dateTime = new \DateTime();
+        $dateTime->setTimestamp($this->getTimestamp());
+        $dateTime->setTimezone(new \DateTimeZone(date_default_timezone_get()));
+
+        return $dateTime;
+    }
 }

src/AbraFlexi/DateTime.php

@@ -70,6 +70,8 @@ public function __toString(): string
     /**
      * Convert Timestamp to Flexi DateTime format.
      *
+     * @deprecated message: Use DateTime::fromTimestamp() instead
+     *
      * @param int $timpestamp
      *
      * @return string AbraFlexi DateTime or NULL
@@ -98,4 +100,26 @@ public function setFormat(string $format)
 
         return $this;
     }
+
+    public static function fromDateTime(\DateTime $when): self
+    {
+        return new self($when->format(self::$format));
+    }
+
+    public static function fromTimestamp(int $timpestamp): self
+    {
+        $flexiDate = new self();
+
+        $flexiDate->setTimestamp($timpestamp);
+
+        return $flexiDate;
+    }
+    public function toDateTime(): \DateTime
+    {
+        $dateTime = new \DateTime();
+        $dateTime->setTimestamp($this->getTimestamp());
+        $dateTime->setTimezone(new \DateTimeZone(date_default_timezone_get()));
+
+        return $dateTime;
+    }
 }

src/AbraFlexi/Functions.php

@@ -225,6 +225,8 @@ public static function flexiUrl(array $data, $joiner = 'and', $defop = 'eq'): st
 
     /**
      * PHP Date object to AbraFlexi date format.
+     *
+     * @deprecated Use Date::dateToFlexiDate() instead
      */
     public static function dateToFlexiDate(\DateTime $date)
     {
@@ -233,6 +235,8 @@ public static function dateToFlexiDate(\DateTime $date)
 
     /**
      * PHP Date object to AbraFlexi date format.
+     *
+     * @abstracted Use DateTime::dateToFlexiDateTime() instead
      */
     public static function dateToFlexiDateTime(\DateTime $dateTime)
     {
@@ -242,6 +246,8 @@ public static function dateToFlexiDateTime(\DateTime $dateTime)
     /**
      * AbraFlexi date to PHP DateTime conversion.
      *
+     * @deprecated Use Date::flexiDateToDateTime() instead
+     *
      * @param string $flexidate 2017-05-26 or 2017-05-26Z or 2017-05-26+02:00
      *
      * @return \DateTime|false
@@ -262,6 +268,8 @@ public static function flexiDateToDateTime(string $flexidate)
     /**
      * AbraFlexi dateTime to PHP DateTime conversion.
      *
+     * @deprecated Use DateTime::flexiDateTimeToDateTime() instead
+     *
      * @param string $flexidatetime 2017-09-26T10:00:53.755+02:00 or older 2017-05-19T00:00:00+02:00
      *
      * @return \DateTime|false