Added DateTime VO

Author: renandelmonico

README.md

@@ -34,6 +34,7 @@ make doc-generate
 - Address
 - Boolean
 - City
+- DateTime
 - Email
 - Integer
 - IP (IPv4 and IPv6)

src/Vo/DateTime.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace RenanDelmonico\Vo;
+
+use DateTime as GlobalDateTime;
+use DateTimeInterface;
+use Exception;
+
+readonly class DateTime implements ValueObjectContract
+{
+    use ValueObjectBehaviors;
+
+    public DateTimeInterface $value;
+
+    /**
+     * @param string $value
+     */
+    public function __construct(string $value)
+    {
+        try {
+            $this->value = new GlobalDateTime($value);
+        } catch (Exception) {
+            throw new InvalidVoException(sprintf(
+                'Invalid value for type %s. Value: \'%s\'',
+                get_class($this),
+                $value
+            ));
+        }
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function getValue(): DateTimeInterface
+    {
+        return $this->value;
+    }
+}

tests/Vo/DateTimeTest.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Test\Vo;
+
+use PHPUnit\Framework\TestCase;
+use RenanDelmonico\Vo\DateTime;
+use RenanDelmonico\Vo\InvalidVoException;
+
+class DateTimeTest extends TestCase
+{
+    public function testShouldInstaceANewDateTimeInstance()
+    {
+        $sut = new DateTime('2023-02-03T04:05:06+00:00');
+
+        $this->assertEquals('2023-02-03 04:05:06', $sut->getValue()->format('Y-m-d H:i:s'));
+    }
+
+    /**
+     * @dataProvider invalidDataProvider
+     */
+    public function testWithInvalidValueShouldThrowAnException()
+    {
+        $value = '2023-31-31T04:05:06+00:00';
+
+        $this->expectException(InvalidVoException::class);
+        $this->expectExceptionMessage(sprintf(
+            'Invalid value for type %s. Value: \'%s\'',
+            DateTime::class,
+            $value
+        ));
+
+        new DateTime($value);
+    }
+
+    public function invalidDataProvider(): array
+    {
+        return [
+            ['2023-31-31T04:05:06+00:00'],
+            ['xpto'],
+            [''],
+            ['12/01/2023'],
+        ];
+    }
+}