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

src/DayOfWeek.php

@@ -213,6 +213,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the capitalized English name of this day-of-week.
      */

src/Duration.php

@@ -761,6 +761,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns an ISO-8601 string representation of this duration.
      *

src/Instant.php

@@ -373,6 +373,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return (string) ZonedDateTime::ofInstant($this, TimeZone::utc());

src/Interval.php

@@ -145,6 +145,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return $this->start . '/' . $this->end;

src/LocalDate.php

@@ -757,6 +757,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the ISO 8601 representation of this LocalDate.
      */

src/LocalDateRange.php

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

src/LocalDateTime.php

@@ -723,6 +723,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return $this->date . 'T' . $this->time;

src/LocalTime.php

@@ -648,6 +648,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns this time as a string, such as 10:15.
      *

src/MonthDay.php

@@ -231,6 +231,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         // This code is optimized for high performance

src/Period.php

@@ -384,6 +384,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         if ($this->isZero()) {

src/Year.php

@@ -243,6 +243,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         return (string) $this->year;

src/YearMonth.php

@@ -298,6 +298,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     /**
      * Returns the ISO 8601 representation of this YearMonth.
      */

src/YearMonthRange.php

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

src/YearWeek.php

@@ -272,6 +272,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         // This code is optimized for high performance

src/ZonedDateTime.php

@@ -717,6 +717,14 @@ public function jsonSerialize(): string
         return (string) $this;
     }
 
+    /**
+     * {@see __toString()}.
+     */
+    public function toISO(): string
+    {
+        return (string) $this;
+    }
+
     public function __toString(): string
     {
         $string = $this->localDateTime . $this->timeZoneOffset;

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 testToISO(int $dayOfWeek, string $expectedName): void
+    {
+        self::assertSame($expectedName, DayOfWeek::of($dayOfWeek)->toISO());
+    }
+
     /**
      * @dataProvider providerToString
      *

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 testToISO(int $seconds, int $nanos, string $expected): void
+    {
+        self::assertSame($expected, Duration::ofSeconds($seconds, $nanos)->toISO());
+    }
+
     /**
      * @dataProvider providerToString
      */

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 testToISO(int $epochSecond, int $nano, string $expectedString): void
+    {
+        self::assertSame($expectedString, Instant::of($epochSecond, $nano)->toISO());
+    }
+
     /**
      * @dataProvider providerToString
      *

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 testToISO(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->toISO());
+    }
+
+    /** @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'],
+        ];
     }
 }