Add toArray() method to Chronos, ChronosDate, and ChronosTime (#506)

Adds a toArray() method to return date/time components as an
associative array. This is the inverse of the existing createFromArray()
method.

- Chronos::toArray() returns year, month, day, hour, minute, second,
  microsecond, and timezone
- ChronosDate::toArray() returns year, month, and day
- ChronosTime::toArray() returns hour, minute, second, and microsecond

Author: dereuromark

src/Chronos.php

@@ -2661,6 +2661,25 @@ public function toNative(): DateTimeImmutable
         return new DateTimeImmutable($this->format('Y-m-d H:i:s.u'), $this->getTimezone());
     }
 
+    /**
+     * Returns the date and time as an associative array.
+     *
+     * @return array{year: int, month: int, day: int, hour: int, minute: int, second: int, microsecond: int, timezone: string}
+     */
+    public function toArray(): array
+    {
+        return [
+            'year' => $this->year,
+            'month' => $this->month,
+            'day' => $this->day,
+            'hour' => $this->hour,
+            'minute' => $this->minute,
+            'second' => $this->second,
+            'microsecond' => $this->microsecond,
+            'timezone' => $this->timezone->getName(),
+        ];
+    }
+
     /**
      * Get a part of the object
      *

src/ChronosDate.php

@@ -1608,6 +1608,20 @@ public function toNative(DateTimeZone|string|null $timezone = null): DateTimeImm
         return $this->toDateTimeImmutable($timezone);
     }
 
+    /**
+     * Returns the date as an associative array.
+     *
+     * @return array{year: int, month: int, day: int}
+     */
+    public function toArray(): array
+    {
+        return [
+            'year' => $this->year,
+            'month' => $this->month,
+            'day' => $this->day,
+        ];
+    }
+
     /**
      * Get a part of the object
      *

src/ChronosTime.php

@@ -521,4 +521,19 @@ public function toNative(DateTimeZone|string|null $timezone = null): DateTimeImm
     {
         return $this->toDateTimeImmutable($timezone);
     }
+
+    /**
+     * Returns the time as an associative array.
+     *
+     * @return array{hour: int, minute: int, second: int, microsecond: int}
+     */
+    public function toArray(): array
+    {
+        return [
+            'hour' => $this->getHours(),
+            'minute' => $this->getMinutes(),
+            'second' => $this->getSeconds(),
+            'microsecond' => $this->getMicroseconds(),
+        ];
+    }
 }

tests/TestCase/ChronosTimeTest.php

@@ -328,4 +328,16 @@ public function testToString(): void
         ChronosTime::resetToStringFormat();
         $this->assertSame('12:13:14', (string)$t);
     }
+
+    public function testToArray(): void
+    {
+        $t = new ChronosTime('12:30:45.123456');
+        $array = $t->toArray();
+
+        $this->assertSame(12, $array['hour']);
+        $this->assertSame(30, $array['minute']);
+        $this->assertSame(45, $array['second']);
+        $this->assertSame(123456, $array['microsecond']);
+        $this->assertCount(4, $array);
+    }
 }

tests/TestCase/Date/GettersTest.php

@@ -26,4 +26,15 @@ public function testHalfOfYear(int $month, int $expectedHalfOfYear): void
         $d = ChronosDate::create(year: 2012, month: $month, day: 1);
         $this->assertSame($expectedHalfOfYear, $d->half);
     }
+
+    public function testToArray(): void
+    {
+        $d = ChronosDate::create(2024, 1, 15);
+        $array = $d->toArray();
+
+        $this->assertSame(2024, $array['year']);
+        $this->assertSame(1, $array['month']);
+        $this->assertSame(15, $array['day']);
+        $this->assertCount(3, $array);
+    }
 }

tests/TestCase/DateTime/GettersTest.php

@@ -333,4 +333,19 @@ public function testInvalidGetter()
         $d = Chronos::now();
         $d->doesNotExit;
     }
+
+    public function testToArray(): void
+    {
+        $d = Chronos::create(2024, 1, 15, 12, 30, 45, 123456, 'America/Toronto');
+        $array = $d->toArray();
+
+        $this->assertSame(2024, $array['year']);
+        $this->assertSame(1, $array['month']);
+        $this->assertSame(15, $array['day']);
+        $this->assertSame(12, $array['hour']);
+        $this->assertSame(30, $array['minute']);
+        $this->assertSame(45, $array['second']);
+        $this->assertSame(123456, $array['microsecond']);
+        $this->assertSame('America/Toronto', $array['timezone']);
+    }
 }