Add Date attribute

Author: Ivan Vasilkov

src/Attributes/Date.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace Composite\Entity\Attributes;
+
+#[\Attribute(\Attribute::TARGET_PARAMETER | \Attribute::TARGET_PROPERTY)]
+class Date
+{
+}

src/Columns/DateTimeColumn.php

@@ -2,6 +2,7 @@
 
 namespace Composite\Entity\Columns;
 
+use Composite\Entity\Attributes\Date;
 use Composite\Entity\Helpers\DateTimeHelper;
 
 class DateTimeColumn extends AbstractColumn
@@ -17,7 +18,8 @@ public function cast(mixed $dbValue): ?\DateTimeInterface
         /** @var class-string<\DateTimeInterface> $class */
         $class = $this->type;
         if (is_string($dbValue)) {
-            return new $class($dbValue);
+            $timeValue = $this->isDate() ? substr($dbValue, 0, 10) : $dbValue;
+            return new $class($timeValue);
         } elseif ($dbValue instanceof $class) {
             return $dbValue;
         } else {
@@ -30,9 +32,17 @@ public function cast(mixed $dbValue): ?\DateTimeInterface
      */
     public function uncast(mixed $entityValue): ?string
     {
+        if ($this->isDate()) {
+            return $entityValue->format(DateTimeHelper::DATE_FORMAT);
+        }
         if ($this->isNullable && DateTimeHelper::isDefault($entityValue)) {
             return null;
         }
         return DateTimeHelper::dateTimeToString($entityValue);
     }
+
+    private function isDate(): bool
+    {
+        return (bool)$this->getFirstAttributeByClass(Date::class);
+    }
 }

src/Helpers/DateTimeHelper.php

@@ -9,6 +9,7 @@ class DateTimeHelper
     final public const DEFAULT_DATETIME = '1000-01-01 00:00:00';
     final public const DEFAULT_DATETIME_MICRO = '1000-01-01 00:00:00.000000';
     final public const DATETIME_FORMAT = 'Y-m-d H:i:s';
+    final public const DATE_FORMAT = 'Y-m-d';
     final public const DATETIME_MICRO_FORMAT = 'Y-m-d H:i:s.u';
 
     public static function getDefaultDateTimeImmutable() : \DateTimeImmutable

tests/Columns/DateTimeColumnTest.php

@@ -3,7 +3,9 @@
 namespace Composite\Entity\Tests\Columns;
 
 use Composite\Entity\AbstractEntity;
+use Composite\Entity\Attributes\Date;
 use Composite\Entity\Helpers\DateTimeHelper;
+use DateTimeImmutable;
 
 final class DateTimeColumnTest extends \PHPUnit\Framework\TestCase
 {
@@ -139,4 +141,79 @@ public function __construct(
         $newEntity = $entity::fromArray(['column' => null]);
         $this->assertNull($newEntity->column);
     }
+
+
+    public static function date_dataProvider(): array
+    {
+        return [
+            [
+                'value' => '2020-01-02 23:59:59',
+                'expected' => '2020-01-02',
+            ],
+            [
+                'value' => '2000-02-02 00:00:00',
+                'expected' => '2000-02-02',
+            ],
+            [
+                'value' => '1990-07-07',
+                'expected' => '1990-07-07',
+            ],
+            [
+                'value' => 'not valid',
+                'expected' => null,
+            ],
+            [
+                'value' => null,
+                'expected' => null,
+            ],
+            [
+                'value' => false,
+                'expected' => null,
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider date_dataProvider
+     */
+    public function test_dateUncast(mixed $value, ?string $expected): void
+    {
+        $class = new class() extends AbstractEntity {
+            public function __construct(
+                #[Date]
+                public ?\DateTimeImmutable $column = null,
+            ) {}
+        };
+
+        $entity = $class::fromArray(['column' => $value]);
+        $actual = $entity->toArray()['column'];
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function test_dateCast(): void
+    {
+        $date = '2000-01-01';
+        $dti = new \DateTimeImmutable($date . ' 12:00:00');
+        $entity = new class($dti) extends AbstractEntity {
+            public function __construct(
+                #[Date]
+                public \DateTimeImmutable $column,
+            ) {}
+        };
+        $entity->resetChangedColumns();
+
+        $actual = $entity->toArray()['column'];
+        $this->assertEquals($date, $actual);
+        $this->assertEmpty($entity->getChangedColumns());
+
+        $entity->column = new DateTimeImmutable($date . ' 23:59:59');
+        $this->assertEmpty($entity->getChangedColumns());
+
+        $newDate = '2020-07-07';
+        $entity->column = new DateTimeImmutable($newDate . ' 07:07:07');
+        $this->assertEquals(
+            ['column' => $newDate],
+            $entity->getChangedColumns(),
+        );
+    }
 }