From 3fdafe7cb2d7df722910d1861127ec2180cb9ac7 Mon Sep 17 00:00:00 2001
From: Corey Taylor <corey.taylor.fl@gmail.com>
Date: Wed, 18 Jun 2025 22:32:06 -0500
Subject: [PATCH] Add ChronosDatePeriod

---
 phpstan.neon                             |  4 ++
 src/ChronosDatePeriod.php                | 83 ++++++++++++++++++++++++
 tests/TestCase/ChronosDatePeriodTest.php | 40 ++++++++++++
 3 files changed, 127 insertions(+)
 create mode 100644 src/ChronosDatePeriod.php
 create mode 100644 tests/TestCase/ChronosDatePeriodTest.php

diff --git a/phpstan.neon b/phpstan.neon
index 4dcb07f0..d956d484 100644
--- a/phpstan.neon
+++ b/phpstan.neon
@@ -17,3 +17,7 @@ parameters:
 			message: "#with generic class DatePeriod but does not specify its types: TDate, TEnd, TRecurrences$#"
 			count: 1
 			path: src/ChronosPeriod.php
+		-
+			message: "#with generic class DatePeriod but does not specify its types: TDate, TEnd, TRecurrences$#"
+			count: 1
+			path: src/ChronosDatePeriod.php
diff --git a/src/ChronosDatePeriod.php b/src/ChronosDatePeriod.php
new file mode 100644
index 00000000..fb4e8b73
--- /dev/null
+++ b/src/ChronosDatePeriod.php
@@ -0,0 +1,83 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @license       https://www.opensource.org/licenses/mit-license.php MIT License
+ */
+
+namespace Cake\Chronos;
+
+use DatePeriod;
+use Iterator;
+
+/**
+ * DatePeriod wrapper that returns Chronos instances.
+ *
+ * @template TKey int
+ * @template TValue \Cake\Chronos\ChronosDate
+ * @template-implements \Iterator<int, \Cake\Chronos\ChronosDate>
+ */
+class ChronosDatePeriod implements Iterator
+{
+    /**
+     * @var \Iterator<int, \DateTimeInterface>
+     */
+    protected Iterator $iterator;
+
+    /**
+     * @param \DatePeriod $period
+     */
+    public function __construct(DatePeriod $period)
+    {
+        /** @var \Iterator<int, \DateTimeInterface> $iterator */
+        $iterator = $period->getIterator();
+        $this->iterator = $iterator;
+    }
+
+    /**
+     * @return \Cake\Chronos\ChronosDate
+     */
+    public function current(): ChronosDate
+    {
+        return new ChronosDate($this->iterator->current());
+    }
+
+    /**
+     * @return int
+     */
+    public function key(): int
+    {
+        return $this->iterator->key();
+    }
+
+    /**
+     * @return void
+     */
+    public function next(): void
+    {
+        $this->iterator->next();
+    }
+
+    /**
+     * @return void
+     */
+    public function rewind(): void
+    {
+        $this->iterator->rewind();
+    }
+
+    /**
+     * @return bool
+     */
+    public function valid(): bool
+    {
+        return $this->iterator->valid();
+    }
+}
diff --git a/tests/TestCase/ChronosDatePeriodTest.php b/tests/TestCase/ChronosDatePeriodTest.php
new file mode 100644
index 00000000..4f88e4de
--- /dev/null
+++ b/tests/TestCase/ChronosDatePeriodTest.php
@@ -0,0 +1,40 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ *
+ * Licensed under The MIT License
+ * Redistributions of files must retain the above copyright notice.
+ *
+ * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
+ * @link          https://cakephp.org CakePHP(tm) Project
+ * @license       https://www.opensource.org/licenses/mit-license.php MIT License
+ */
+
+namespace Cake\Chronos\Test\TestCase;
+
+use Cake\Chronos\ChronosDate;
+use Cake\Chronos\ChronosDatePeriod;
+use DateInterval;
+use DatePeriod;
+use DateTime;
+
+class ChronosDatePeriodTest extends TestCase
+{
+    public function testChronosPeriod(): void
+    {
+        $period = new ChronosDatePeriod(new DatePeriod(new DateTime('2025-01-01 00:00:00'), new DateInterval('P1D'), 3));
+        $output = [];
+        foreach ($period as $key => $value) {
+            $output[$key] = $value;
+        }
+        $this->assertCount(4, $output);
+        $this->assertInstanceOf(ChronosDAte::class, $output[0]);
+        $this->assertSame('2025-01-01 00:00:00', $output[0]->format('Y-m-d H:i:s'));
+        $this->assertInstanceOf(ChronosDate::class, $output[1]);
+        $this->assertSame('2025-01-02 00:00:00', $output[1]->format('Y-m-d H:i:s'));
+        $this->assertInstanceOf(ChronosDate::class, $output[3]);
+        $this->assertSame('2025-01-04 00:00:00', $output[3]->format('Y-m-d H:i:s'));
+    }
+}