Option for custom datetime format for creating object (#127)

Author: freezy-sk

docs/source/index.html.md

@@ -444,6 +444,7 @@ result. If data of other types is encountered automatic conversion is attempted
 
 Option | Type | Description
 ------ | ---- | -----------
+createFromFormat | string | Custom format for creating DateTime objects from values. A format string accepted by [`DateTime::createFromFormat()`](https://www.php.net/manual/en/datetime.createfromformat.php) function.
 format | string | A date format string as accepted by the [`date()`](http://php.net/manual/en/function.date.php) function. Default `'c'`.
 nullValue | string | Raw string to display for null values. Defaults to the empty string.
 

src/Column/DateTimeColumn.php

@@ -28,8 +28,18 @@ public function normalize($value)
     {
         if (null === $value) {
             return $this->options['nullValue'];
-        } elseif (!$value instanceof \DateTimeInterface) {
-            $value = new \DateTime((string) $value);
+        }
+
+        if (!$value instanceof \DateTimeInterface) {
+            if (!empty($this->options['createFromFormat'])) {
+                $value = \DateTime::createFromFormat($this->options['createFromFormat'], (string) $value);
+                if ($value === false) {
+                    $errors = \DateTime::getLastErrors();
+                    throw new \Exception(implode(', ', $errors['errors'] ?: $errors['warnings']));
+                }
+            } else {
+                $value = new \DateTime((string)$value);
+            }
         }
 
         return $value->format($this->options['format']);
@@ -44,9 +54,11 @@ protected function configureOptions(OptionsResolver $resolver)
 
         $resolver
             ->setDefaults([
+                'createFromFormat' => '',
                 'format' => 'c',
                 'nullValue' => '',
             ])
+            ->setAllowedTypes('createFromFormat', 'string')
             ->setAllowedTypes('format', 'string')
             ->setAllowedTypes('nullValue', 'string')
         ;

tests/Unit/ColumnTest.php

@@ -41,6 +41,17 @@ public function testDateTimeColumn()
         $this->assertSame('foo', $column->transform(null));
     }
 
+    public function testDateTimeColumnWithCreateFromFormat()
+    {
+        $column = new DateTimeColumn();
+        $column->initialize('test', 1, [
+            'format' => 'd.m.Y H:i:s',
+            'createFromFormat' => 'Y-m-d\TH:i:sP',
+        ], (new DataTable($this->createMock(EventDispatcher::class)))->setName('foo'));
+
+        $this->assertSame('19.02.2020 22:30:34', $column->transform('2020-02-19T22:30:34+00:00'));
+    }
+
     public function testTextColumn()
     {
         $column = new TextColumn();