Keep the single-argument parse functions for binary compatibility (#345)

Author: dkhalanskyjb

core/jvm/src/Instant.kt

@@ -82,6 +82,9 @@ public actual class Instant internal constructor(internal val value: jtInstant)
                 }
             }
 
+        @Deprecated("This overload is only kept for binary compatibility", level = DeprecationLevel.HIDDEN)
+        public fun parse(isoString: String): Instant = parse(input = isoString)
+
         /** A workaround for a quirk of the JDKs older than 11 where the string representations of Instant that have an
          * offset of the form "+XX" are not recognized by [jtOffsetDateTime.parse], while "+XX:XX" work fine. */
         private fun fixOffsetRepresentation(isoString: CharSequence): CharSequence {

core/jvm/src/LocalDate.kt

@@ -30,6 +30,9 @@ public actual class LocalDate internal constructor(internal val value: jtLocalDa
                 format.parse(input)
             }
 
+        @Deprecated("This overload is only kept for binary compatibility", level = DeprecationLevel.HIDDEN)
+        public fun parse(isoString: String): LocalDate = parse(input = isoString)
+
         internal actual val MIN: LocalDate = LocalDate(jtLocalDate.MIN)
         internal actual val MAX: LocalDate = LocalDate(jtLocalDate.MAX)
 

core/jvm/src/LocalDateTime.kt

@@ -68,6 +68,9 @@ public actual class LocalDateTime internal constructor(internal val value: jtLoc
                 format.parse(input)
             }
 
+        @Deprecated("This overload is only kept for binary compatibility", level = DeprecationLevel.HIDDEN)
+        public fun parse(isoString: String): LocalDateTime = parse(input = isoString)
+
         internal actual val MIN: LocalDateTime = LocalDateTime(jtLocalDateTime.MIN)
         internal actual val MAX: LocalDateTime = LocalDateTime(jtLocalDateTime.MAX)
 

core/jvm/src/LocalTime.kt

@@ -56,6 +56,9 @@ public actual class LocalTime internal constructor(internal val value: jtLocalTi
                 format.parse(input)
             }
 
+        @Deprecated("This overload is only kept for binary compatibility", level = DeprecationLevel.HIDDEN)
+        public fun parse(isoString: String): LocalTime = parse(input = isoString)
+
         public actual fun fromSecondOfDay(secondOfDay: Int): LocalTime = try {
             jtLocalTime.ofSecondOfDay(secondOfDay.toLong()).let(::LocalTime)
         } catch (e: DateTimeException) {

core/jvm/src/UtcOffsetJvm.kt

@@ -31,6 +31,9 @@ public actual class UtcOffset(internal val zoneOffset: ZoneOffset) {
             else -> format.parse(input)
         }
 
+        @Deprecated("This overload is only kept for binary compatibility", level = DeprecationLevel.HIDDEN)
+        public fun parse(offsetString: String): UtcOffset = parse(input = offsetString)
+
         @Suppress("FunctionName")
         public actual fun Format(block: DateTimeFormatBuilder.WithUtcOffset.() -> Unit): DateTimeFormat<UtcOffset> =
             UtcOffsetFormat.build(block)