Merge pull request #395 from cakephp/3.x-readd-setisodate

3.x: re-add setISODate

src/Chronos.php

@@ -879,6 +879,22 @@ public function setDate(int $year, int $month, int $day): static
         return $new;
     }
 
+    /**
+     * Sets the date according to the ISO 8601 standard
+     *
+     * @param int $year Year of the date.
+     * @param int $week Week of the date.
+     * @param int $dayOfWeek Offset from the first day of the week.
+     * @return static
+     */
+    public function setISODate(int $year, int $week, int $dayOfWeek = 1): static
+    {
+        $new = clone $this;
+        $new->native = $new->native->setISODate($year, $week, $dayOfWeek);
+
+        return $new;
+    }
+
     /**
      * Sets the time.
      *

src/ChronosDate.php

@@ -353,6 +353,22 @@ public function setDate(int $year, int $month, int $day): static
         return $new;
     }
 
+    /**
+     * Sets the date according to the ISO 8601 standard
+     *
+     * @param int $year Year of the date.
+     * @param int $week Week of the date.
+     * @param int $dayOfWeek Offset from the first day of the week.
+     * @return static
+     */
+    public function setISODate(int $year, int $week, int $dayOfWeek = 1): static
+    {
+        $new = clone $this;
+        $new->native = $new->native->setISODate($year, $week, $dayOfWeek);
+
+        return $new;
+    }
+
     /**
      * Returns the difference between this instance and target.
      *

tests/TestCase/DateTime/FluidSettersTest.php

@@ -16,6 +16,7 @@
 namespace Cake\Chronos\Test\TestCase\DateTime;
 
 use Cake\Chronos\Chronos;
+use Cake\Chronos\ChronosDate;
 use Cake\Chronos\Test\TestCase\TestCase;
 
 class FluidSettersTest extends TestCase
@@ -68,6 +69,22 @@ public function testFluidSetDate()
         $this->assertDateTime($d, 1996, 2, 1);
     }
 
+    public function testFluidChronosSetISODate()
+    {
+        $d = Chronos::createFromDate(2000, 1, 1);
+        $d = $d->setISODate(2023, 17, 3);
+        $this->assertTrue($d instanceof Chronos);
+        $this->assertDateTime($d, 2023, 04, 26);
+    }
+
+    public function testFluidChronosDateSetISODate()
+    {
+        $d = ChronosDate::create(2000, 1, 1);
+        $d = $d->setISODate(2023, 17, 3);
+        $this->assertTrue($d instanceof ChronosDate);
+        $this->assertDateTime($d, 2023, 04, 26);
+    }
+
     public function testFluidHourSetter()
     {
         $d = Chronos::now();