Getter for 'from', 'to' event's configuration

src/Event.php

@@ -88,6 +88,16 @@ class Event implements PingableInterface
      */
     protected $timezone;
 
+    /**
+     * Datetime or time since the task is evaluated and possibly executed only for display purposes.
+     */
+    protected \DateTime|string|null $from = null;
+
+    /**
+     * Datetime or time until the task is evaluated and possibly executed only for display purposes.
+     */
+    protected \DateTime|string|null $to = null;
+
     /**
      * The user the command should run as.
      *
@@ -447,6 +457,8 @@ public function between($from, $to)
      */
     public function from($datetime)
     {
+        $this->from = $datetime;
+
         return $this->skip(fn () => $this->notYet($datetime));
     }
 
@@ -459,6 +471,8 @@ public function from($datetime)
      */
     public function to($datetime)
     {
+        $this->to = $datetime;
+
         return $this->skip(fn () => $this->past($datetime));
     }
 
@@ -921,6 +935,22 @@ public function getExpression()
         return $this->expression;
     }
 
+    /**
+     * Get the 'from' configuration for the event if present.
+     */
+    public function getFrom(): \DateTime|string|null
+    {
+        return $this->from;
+    }
+
+    /**
+     * Get the 'to' configuration for the event if present.
+     */
+    public function getTo(): \DateTime|string|null
+    {
+        return $this->to;
+    }
+
     /**
      * Set the event's command.
      *

tests/Unit/EventTest.php

@@ -154,6 +154,45 @@ public function test_cron_life_time(): void
         );
     }
 
+    public function test_get_from(): void
+    {
+        $timezone = new \DateTimeZone('UTC');
+
+        $dateFrom = '2023-10-01';
+
+        $event = new Event($this->id, 'php foo');
+        $event->from($dateFrom);
+
+        self::assertSame($dateFrom, $event->getFrom());
+    }
+
+    public function test_get_to(): void
+    {
+        $timezone = new \DateTimeZone('UTC');
+
+        $dateTo = '2023-10-30';
+
+        $event = new Event($this->id, 'php foo');
+        $event->to($dateTo);
+
+        self::assertSame($dateTo, $event->getTo());
+    }
+
+    public function test_get_between(): void
+    {
+        $timezone = new \DateTimeZone('UTC');
+
+        $dateFrom = '2023-10-01';
+        $dateTo = '2023-10-30';
+
+        $event = new Event($this->id, 'php foo');
+        $event->between($dateFrom, $dateTo);
+
+        self::assertSame($dateFrom, $event->getFrom());
+
+        self::assertSame($dateTo, $event->getTo());
+    }
+
     public function test_cron_conditions(): void
     {
         $timezone = new \DateTimeZone('UTC');