polish/fix: control over 'includeTime' of Date

- introduce new methods for actively including time ('include Time') of a Date Properties within a Notion Page
- existing init of value for a Date Property will force a date without time
- ::valueWithTime(...) in Date Property and ->setDateTime(...) in Page will force the inclusion of time, if pushed to Notion
- ! breaking: result of ::value(...) of Date Property and ->setDate(...) of Page are changing (time will not be included)

Author: johguentner

src/Entities/Page.php

@@ -344,6 +344,19 @@ public function setDate(string $propertyTitle, DateTime $start, ?DateTime $end =
         return $this;
     }
 
+    /**
+     * @param $propertyTitle
+     * @param $start
+     * @param $end
+     * @return Page
+     */
+    public function setDateTime(string $propertyTitle, DateTime $start, ?DateTime $end = null): Page
+    {
+        $this->set($propertyTitle, Date::valueWithTime($start, $end));
+
+        return $this;
+    }
+
     /**
      * @param $propertyTitle
      * @param $relationIds

src/Entities/Properties/Date.php

@@ -26,6 +26,39 @@ public static function value(?DateTime $start, ?DateTime $end = null): Date
         $dateProperty = new Date();
         $dateProperty->content = $richDate;
 
+        if ($richDate->isRange()) {
+            $dateProperty->rawContent = [
+                'date' => [
+                    'start' => $start->format('Y-m-d'),
+                    'end' => $end->format('Y-m-d'),
+                ],
+            ];
+        } else {
+            $dateProperty->rawContent = [
+                'date' => [
+                    'start' => $start->format('Y-m-d'),
+                ],
+            ];
+        }
+
+        return $dateProperty;
+    }
+
+    /**
+     * @param $start
+     * @param $end
+     * @return Date
+     */
+    public static function valueWithTime(?DateTime $start, ?DateTime $end = null): Date
+    {
+        $richDate = new RichDate();
+        $richDate->setStart($start);
+        $richDate->setEnd($end);
+        $richDate->setHasTime(true);
+
+        $dateProperty = new Date();
+        $dateProperty->content = $richDate;
+
         if ($richDate->isRange()) {
             $dateProperty->rawContent = [
                 'date' => [

src/Entities/PropertyItems/RichDate.php

@@ -11,11 +11,9 @@
  */
 class RichDate extends Entity
 {
-    /**
-     * @var string
-     */
     protected DateTime $start;
     protected ?DateTime $end = null;
+    protected bool $hasTime = false;
 
     /**
      * @param  array  $responseData
@@ -70,6 +68,14 @@ public function getEnd(): ?DateTime
         return $this->end;
     }
 
+    /**
+     * @return bool
+     */
+    public function getHasTime(): bool
+    {
+        return $this->hasTime;
+    }
+
     public function setStart($start): void
     {
         $this->start = $start;
@@ -79,4 +85,9 @@ public function setEnd($end): void
     {
         $this->end = $end;
     }
+
+    public function setHasTime($hasTime): void
+    {
+        $this->hasTime = $hasTime;
+    }
 }