Fix docs mentioning internal class DateTimeFormatException (#87)

Fixes #85

Author: dkhalanskyjb

core/common/src/Instant.kt

@@ -128,7 +128,7 @@ public expect class Instant : Comparable<Instant> {
          * - `2020-08-30T18:43:00.500Z`
          * - `2020-08-30T18:43:00.123456789Z`
          *
-         * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [Instant] are exceeded.
+         * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [Instant] are exceeded.
          */
         fun parse(isoString: String): Instant
 
@@ -168,7 +168,7 @@ public val Instant.isDistantFuture
  *
  * See [Instant.parse] for examples of instant string representations.
  *
- * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [Instant] are exceeded.
+ * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [Instant] are exceeded.
  */
 public fun String.toInstant(): Instant = Instant.parse(this)
 

core/common/src/LocalDate.kt

@@ -13,7 +13,7 @@ public expect class LocalDate : Comparable<LocalDate> {
          *
          * An example of a local date in ISO-8601 format: `2020-08-30`.
          *
-         * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [LocalDate] are exceeded.
+         * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [LocalDate] are exceeded.
          */
         public fun parse(isoString: String): LocalDate
 
@@ -86,7 +86,7 @@ public expect class LocalDate : Comparable<LocalDate> {
  *
  * See [LocalDate.parse] for examples of local date string representations.
  *
- * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [LocalDate] are exceeded.
+ * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [LocalDate] are exceeded.
  */
 public fun String.toLocalDate(): LocalDate = LocalDate.parse(this)
 
@@ -186,7 +186,7 @@ public expect fun LocalDate.daysUntil(other: LocalDate): Int
 public expect fun LocalDate.monthsUntil(other: LocalDate): Int
 
 /**
- * Returns the number of whole years between two instants in the specified [timeZone].
+ * Returns the number of whole years between two dates.
  *
  * If the result does not fit in [Int], returns [Int.MAX_VALUE] for a positive result or [Int.MIN_VALUE] for a negative result.
  *

core/common/src/LocalDateTime.kt

@@ -20,7 +20,7 @@ public expect class LocalDateTime : Comparable<LocalDateTime> {
          * - `2020-08-30T18:43:00.500`
          * - `2020-08-30T18:43:00.123456789`
          *
-         * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [LocalDateTime] are
+         * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [LocalDateTime] are
          * exceeded.
          */
         public fun parse(isoString: String): LocalDateTime
@@ -113,7 +113,7 @@ public expect class LocalDateTime : Comparable<LocalDateTime> {
  *
  * See [LocalDateTime.parse] for examples of date/time string representations.
  *
- * @throws DateTimeFormatException if the text cannot be parsed or the boundaries of [LocalDateTime] are exceeded.
+ * @throws IllegalArgumentException if the text cannot be parsed or the boundaries of [LocalDateTime] are exceeded.
  */
 public fun String.toLocalDateTime(): LocalDateTime = LocalDateTime.parse(this)