Add toISOString() methods (same as __toString()).

brick · Oct 2, 2023 · 597381c · 597381c
1 parent 7310295
commit 597381c
Show file tree

Hide file tree

Showing 30 changed files with 439 additions and 47 deletions.
diff --git a/src/DayOfWeek.php b/src/DayOfWeek.php
@@ -213,6 +213,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the capitalized English name of this day-of-week.
      */

diff --git a/src/Duration.php b/src/Duration.php
@@ -761,6 +761,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns an ISO-8601 string representation of this duration.
      *

diff --git a/src/Instant.php b/src/Instant.php
@@ -373,6 +373,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return (string) ZonedDateTime::ofInstant($this, TimeZone::utc());

diff --git a/src/Interval.php b/src/Interval.php
@@ -145,6 +145,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return $this->start . '/' . $this->end;

diff --git a/src/LocalDate.php b/src/LocalDate.php
@@ -754,6 +754,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the ISO 8601 representation of this LocalDate.
      */

diff --git a/src/LocalDateRange.php b/src/LocalDateRange.php
@@ -259,6 +259,14 @@ public function toNativeDatePeriod(): DatePeriod
         return new DatePeriod($start, $interval, $end);
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns an ISO 8601 string representation of this date range.
      */

diff --git a/src/LocalDateTime.php b/src/LocalDateTime.php
@@ -723,6 +723,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return $this->date . 'T' . $this->time;

diff --git a/src/LocalTime.php b/src/LocalTime.php
@@ -647,6 +647,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns this time as a string, such as 10:15.
      *

diff --git a/src/MonthDay.php b/src/MonthDay.php
@@ -233,6 +233,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return sprintf('--%02d-%02d', $this->month, $this->day);

diff --git a/src/Period.php b/src/Period.php
@@ -384,6 +384,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         if ($this->isZero()) {

diff --git a/src/Year.php b/src/Year.php
@@ -243,6 +243,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return (string) $this->year;

diff --git a/src/YearMonth.php b/src/YearMonth.php
@@ -295,6 +295,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the ISO 8601 representation of this YearMonth.
      */

diff --git a/src/YearMonthRange.php b/src/YearMonthRange.php
@@ -187,6 +187,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns a string representation of this year-month range.
      *

diff --git a/src/YearWeek.php b/src/YearWeek.php
@@ -269,6 +269,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         $pattern = ($this->year < 0 ? '%05d' : '%04d') . '-W%02d';

diff --git a/src/ZonedDateTime.php b/src/ZonedDateTime.php
@@ -717,6 +717,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISOString(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         $string = $this->localDateTime . $this->timeZoneOffset;

diff --git a/tests/DayOfWeekTest.php b/tests/DayOfWeekTest.php
@@ -286,6 +286,17 @@ public function testJsonSerialize(int $dayOfWeek, string $expectedName): void
         self::assertSame(json_encode($expectedName), json_encode(DayOfWeek::of($dayOfWeek)));
     }
 
+    /**
+     * @dataProvider providerToString
+     *
+     * @param int    $dayOfWeek    The day-of-week value, from 1 to 7.
+     * @param string $expectedName The expected name.
+     */
+    public function testToISOString(int $dayOfWeek, string $expectedName): void
+    {
+        self::assertSame($expectedName, DayOfWeek::of($dayOfWeek)->toISOString());
+    }
+
     /**
      * @dataProvider providerToString
      *

diff --git a/tests/DurationTest.php b/tests/DurationTest.php
@@ -1282,6 +1282,14 @@ public function testJsonSerialize(int $seconds, int $nanos, string $expected): v
         self::assertSame(json_encode($expected), json_encode(Duration::ofSeconds($seconds, $nanos)));
     }
 
+    /**
+     * @dataProvider providerToString
+     */
+    public function testToISOString(int $seconds, int $nanos, string $expected): void
+    {
+        self::assertSame($expected, Duration::ofSeconds($seconds, $nanos)->toISOString());
+    }
+
     /**
      * @dataProvider providerToString
      */

diff --git a/tests/InstantTest.php b/tests/InstantTest.php
@@ -645,6 +645,18 @@ public function testJsonSerialize(int $epochSecond, int $nano, string $expectedS
         self::assertSame(json_encode($expectedString), json_encode(Instant::of($epochSecond, $nano)));
     }
 
+    /**
+     * @dataProvider providerToString
+     *
+     * @param int    $epochSecond    The epoch second to test.
+     * @param int    $nano           The nano adjustment to the epoch second.
+     * @param string $expectedString The expected string output.
+     */
+    public function testToISOString(int $epochSecond, int $nano, string $expectedString): void
+    {
+        self::assertSame($expectedString, Instant::of($epochSecond, $nano)->toISOString());
+    }
+
     /**
      * @dataProvider providerToString
      *

diff --git a/tests/IntervalTest.php b/tests/IntervalTest.php
@@ -260,23 +260,44 @@ public function providerIsEqualTo(): array
         ];
     }
 
-    public function testJsonSerialize(): void
+    /** @dataProvider providerToString */
+    public function testJsonSerialize(int $epochSecondStart, int $epochSecondEnd, string $expectedString): void
     {
         $interval = Interval::of(
-            Instant::of(1000000000),
-            Instant::of(2000000000)
+            Instant::of($epochSecondStart),
+            Instant::of($epochSecondEnd)
         );
 
-        self::assertSame(json_encode('2001-09-09T01:46:40Z/2033-05-18T03:33:20Z'), json_encode($interval));
+        self::assertSame(json_encode($expectedString), json_encode($interval));
     }
 
-    public function testToString(): void
+    /** @dataProvider providerToString */
+    public function testToISOString(int $epochSecondStart, int $epochSecondEnd, string $expectedString): void
     {
         $interval = Interval::of(
-            Instant::of(1000000000),
-            Instant::of(2000000000)
+            Instant::of($epochSecondStart),
+            Instant::of($epochSecondEnd)
         );
 
-        self::assertSame('2001-09-09T01:46:40Z/2033-05-18T03:33:20Z', (string) $interval);
+        self::assertSame($expectedString, $interval->toISOString());
+    }
+
+    /** @dataProvider providerToString */
+    public function testToString(int $epochSecondStart, int $epochSecondEnd, string $expectedString): void
+    {
+        $interval = Interval::of(
+            Instant::of($epochSecondStart),
+            Instant::of($epochSecondEnd)
+        );
+
+        self::assertSame($expectedString, (string) $interval);
+    }
+
+    public function providerToString(): array
+    {
+        return [
+            [1000000000, 1000000000, '2001-09-09T01:46:40Z/2001-09-09T01:46:40Z'],
+            [1000000000, 2000000000, '2001-09-09T01:46:40Z/2033-05-18T03:33:20Z'],
+        ];
     }
 }