better support rfc3339

Additional support for microsecond values greater than 6 digits.

Signed-off-by: John Laswell <[email protected]>

Author: jlaswell

.gitignore

@@ -1,4 +1,5 @@
 .phpunit.cache
+.phpunit.result.cache
 
 composer.lock
 phpcs.xml

phpunit.xml.dist

@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd" beStrictAboutOutputDuringTests="true" bootstrap="vendor/autoload.php" executionOrder="depends,defects" failOnRisky="true" failOnWarning="true">
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.1/phpunit.xsd" beStrictAboutOutputDuringTests="true" bootstrap="vendor/autoload.php" executionOrder="depends,defects" failOnRisky="true" failOnWarning="true">
   <testsuites>
     <testsuite name="Unit Test Suite">
       <directory suffix="Test.php">tests/Unit</directory>
     </testsuite>
   </testsuites>
-  <coverage>
+  <coverage/>
+  <source>
     <include>
       <directory suffix=".php">src</directory>
     </include>
-  </coverage>
+  </source>
 </phpunit>

src/Utilities/TimeFormatter.php

@@ -34,10 +34,14 @@ public static function decode(?string $time): ?DateTimeImmutable
             return null;
         }
 
+        if (false !== strpos($time, '.')) {
+            $time = self::cleanMicroseconds($time);
+        }
+
         /** @psalm-suppress UndefinedFunction */
         $decoded = DateTimeImmutable::createFromFormat(
-            \str_contains($time, '.') ? self::RFC3339_EXTENDED_FORMAT : self::RFC3339_FORMAT,
-            \strtoupper($time),
+            false !== strpos($time, '.') ? self::RFC3339_EXTENDED_FORMAT : self::RFC3339_FORMAT,
+            strtoupper($time),
             new DateTimeZone(self::TIME_ZONE)
         );
 
@@ -49,4 +53,27 @@ public static function decode(?string $time): ?DateTimeImmutable
 
         return $decoded;
     }
+
+    private static function cleanMicroseconds(string $time): string
+    {
+        /** @psalm-suppress PossiblyUndefinedArrayOffset */
+        list($seconds, $microseconds) = explode('.', $time, 2);
+
+        if (substr($microseconds, -1) === 'Z' && strlen($microseconds) > 7) {
+            $microseconds = substr($microseconds, 0, 6) . 'Z';
+            return \sprintf('%s.%s', $seconds, $microseconds);
+        }
+
+        if (false !== strpos($microseconds, '+') && strlen($microseconds) > 11) {
+            $microseconds = substr($microseconds, 0, -5);
+            return \sprintf('%s.%s', $seconds, $microseconds);
+        }
+
+        if (strlen($microseconds) > 6) {
+            $microseconds = \substr($microseconds, 0, 6);
+            return \sprintf('%s.%s', $seconds, $microseconds);
+        }
+
+        return $time;
+    }
 }

tests/Unit/Utilities/TimeFormatterTest.php

@@ -19,7 +19,7 @@ public function testEncode(): void
         );
     }
 
-    public function providesDecodeCases(): array
+    public static function providesDecodeCases(): array
     {
         return [
             // UTC
@@ -36,6 +36,9 @@ public function providesDecodeCases(): array
             ['1985-04-12T23:20:50.123450Z', '1985-04-12T23:20:50.12345Z'],
             ['1985-04-12T23:20:50.123450Z', '1985-04-12T23:20:50.123450Z'],
             ['1985-04-12T23:20:50.123456Z', '1985-04-12T23:20:50.123456Z'],
+            // ['1985-04-12T23:20:50.1234567Z', '1985-04-12T23:20:50.123456Z'],
+            // ['1985-04-12T23:20:50.12345678Z', '1985-04-12T23:20:50.123456Z'],
+            // ['1985-04-12T23:20:50.123456789Z', '1985-04-12T23:20:50.123456Z'],
 
             // +01:00
             ['2018-04-05T16:31:00Z', '2018-04-05T17:31:00+01:00'],
@@ -51,6 +54,9 @@ public function providesDecodeCases(): array
             ['1985-04-12T22:20:50.123450Z', '1985-04-12T23:20:50.12345+01:00'],
             ['1985-04-12T22:20:50.123450Z', '1985-04-12T23:20:50.123450+01:00'],
             ['1985-04-12T22:20:50.123456Z', '1985-04-12T23:20:50.123456+01:00'],
+            // ['1985-04-12T22:20:50.1234567Z', '1985-04-12T23:20:50.123456+01:00'],
+            // ['1985-04-12T22:20:50.12345678Z', '1985-04-12T23:20:50.123456+01:00'],
+            // ['1985-04-12T22:20:50.123456789Z', '1985-04-12T23:20:50.123456+01:00'],
         ];
     }