Release 2.16 (#4780)

src/Doctrine/UTCDateTimeImmutableType.php

@@ -0,0 +1,77 @@
+<?php
+
+/*
+ * This file is part of the Kimai time-tracking app.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Doctrine;
+
+use Doctrine\DBAL\Platforms\AbstractPlatform;
+use Doctrine\DBAL\Types\ConversionException;
+use Doctrine\DBAL\Types\DateTimeImmutableType;
+use Doctrine\DBAL\Types\Types;
+
+final class UTCDateTimeImmutableType extends DateTimeImmutableType
+{
+    /**
+     * @var \DateTimeZone|null
+     */
+    private static ?\DateTimeZone $utc = null;
+
+    /**
+     * @param T $value
+     * @return (T is null ? null : string)
+     * @template T<\DateTimeImmutable>
+     * @throws ConversionException
+     */
+    public function convertToDatabaseValue($value, AbstractPlatform $platform): ?string
+    {
+        if ($value instanceof \DateTimeImmutable) {
+            $value = clone $value;
+            $value = $value->setTimezone(self::getUtc());
+        }
+
+        return parent::convertToDatabaseValue($value, $platform);
+    }
+
+    public static function getUtc(): \DateTimeZone
+    {
+        if (self::$utc === null) {
+            self::$utc = new \DateTimeZone('UTC');
+        }
+
+        return self::$utc;
+    }
+
+    /**
+     * @param mixed $value
+     * @throws ConversionException
+     */
+    public function convertToPHPValue($value, AbstractPlatform $platform): ?\DateTimeImmutable
+    {
+        if (null === $value || $value instanceof \DateTimeImmutable) {
+            return $value;
+        }
+
+        if (\is_string($value)) {
+            $converted = \DateTimeImmutable::createFromFormat(
+                $platform->getDateTimeFormatString(),
+                $value,
+                self::getUtc()
+            );
+
+            if ($converted !== false) {
+                return $converted;
+            }
+        }
+
+        throw ConversionException::conversionFailedFormat(
+            $value,
+            Types::DATETIME_IMMUTABLE,
+            $platform->getDateTimeFormatString()
+        );
+    }
+}