feat: Allow default date time format to be changed

Author: pl-github

src/Convert/Convert.php

@@ -19,6 +19,8 @@ final class Convert
 {
     private static DateTimeZone|null $dateTimeZone = null;
 
+    private static string $dateTimeFormat = 'c';
+
     /** @return ($value is null ? null : bool) */
     public static function asBool(mixed $value): bool|null
     {
@@ -142,7 +144,7 @@ public static function asDateTimeString(mixed $value): string|null
 
         $value = asDateTimeImmutable($value);
 
-        return $value->format('c');
+        return $value->format(self::dateTimeFormat());
     }
 
     public static function timeZone(DateTimeZone|string|null $timeZone = null): DateTimeZone
@@ -157,4 +159,13 @@ public static function timeZone(DateTimeZone|string|null $timeZone = null): Date
 
         return self::$dateTimeZone;
     }
+
+    public static function dateTimeFormat(string|null $dateTimeFormat = null): string
+    {
+        if ($dateTimeFormat !== null) {
+            self::$dateTimeFormat = $dateTimeFormat;
+        }
+
+        return self::$dateTimeFormat;
+    }
 }

tests/Convert/AsDateTimeStringTest.php

@@ -22,6 +22,18 @@
 #[CoversFunction('\Plook\TypeGuard\Convert\asString')]
 final class AsDateTimeStringTest extends TestCase
 {
+    private readonly string $originalDateTimeFormat;
+
+    protected function setUp(): void
+    {
+        $this->originalDateTimeFormat = Convert::dateTimeFormat();
+    }
+
+    protected function tearDown(): void
+    {
+        Convert::dateTimeFormat($this->originalDateTimeFormat);
+    }
+
     public function testConvertsStrings(): void
     {
         self::assertSame('2010-09-08T07:06:05+02:00', asDateTimeString('2010-09-08T07:06:05+02:00'));
@@ -35,6 +47,13 @@ public function testConvertsStringables(): void
         );
     }
 
+    public function testDateTimeFormatCanBeChanged(): void
+    {
+        Convert::dateTimeFormat('Y-m-d');
+
+        self::assertSame('2010-09-08', asDateTimeString('2010-09-08T07:06:05+02:00'));
+    }
+
     public function testDoesNotTouchNull(): void
     {
         self::assertNull(asDateTimeString(null));