Cleanup

Author: dkhalanskyjb

core/common/src/LocalDate.kt

@@ -48,6 +48,8 @@ import kotlin.internal.*
  * [LocalDate] can be constructed directly from its components using the constructor.
  * See sample 1.
  *
+ * A non-throwing version of the constructor is the [orNull] function.
+ *
  * [fromEpochDays] can be used to obtain a [LocalDate] from the number of days since the epoch day `1970-01-01`;
  * [toEpochDays] is the inverse operation.
  * See sample 2.
@@ -107,6 +109,7 @@ public expect class LocalDate : Comparable<LocalDate> {
          * @sample kotlinx.datetime.test.samples.LocalDateSamples.orNull
          */
         public fun orNull(year: Int, month: Month, day: Int): LocalDate?
+
         /**
          * A shortcut for calling [DateTimeFormat.parse].
          *

core/common/src/LocalDateTime.kt

@@ -87,6 +87,8 @@ import kotlin.jvm.JvmName
  * [LocalDateTime] can be constructed directly from its components, [LocalDate] and [LocalTime], using the constructor.
  * See sample 1.
  *
+ * A non-throwing version of the constructor is the [orNull] function.
+ *
  * Some additional constructors that directly accept the values from date and time fields are provided for convenience.
  * See sample 2.
  *
@@ -174,7 +176,6 @@ public expect class LocalDateTime : Comparable<LocalDateTime> {
             nanosecond: Int = 0
         ): LocalDateTime?
 
-
         /**
          * A shortcut for calling [DateTimeFormat.parse].
          *

core/common/src/LocalTime.kt

@@ -58,6 +58,8 @@ import kotlin.jvm.JvmName
  *
  * [LocalTime] can be constructed directly from its components using the constructor. See sample 1.
  *
+ * A non-throwing version of the constructor is the [orNull] function.
+ *
  * [fromSecondOfDay], [fromMillisecondOfDay], and [fromNanosecondOfDay] can be used to obtain a [LocalTime] from the
  * number of seconds, milliseconds, or nanoseconds since the start of the day, assuming that the offset from the UTC
  * does not change during the day.
@@ -83,7 +85,6 @@ import kotlin.jvm.JvmName
 @Serializable(LocalTimeSerializer::class)
 public expect class LocalTime : Comparable<LocalTime> {
     public companion object {
-
         /**
          * Constructs a [LocalTime] instance from the given time components
          * or returns `null` if a value is out of range.

core/common/src/UtcOffset.kt

@@ -38,6 +38,8 @@ import kotlinx.serialization.Serializable
  * [totalSeconds] returns the number of seconds from UTC.
  * See sample 1.
  *
+ * A non-throwing version of the constructor is the [orNull] function.
+ *
  * There is also a [ZERO] constant for the offset of zero.
  *
  * [parse] and [toString] methods can be used to obtain a [UtcOffset] from and convert it to a string in the

core/common/test/samples/LocalDateTimeSamples.kt

@@ -208,7 +208,6 @@ class LocalDateTimeSamples {
         check(LocalDateTime.orNull(2024, Month.FEBRUARY, 15, 24, 48) == null) // Invalid hour
     }
 
-
     @Test
     fun formatting() {
         // Formatting LocalDateTime values using predefined and custom formats

core/commonKotlin/src/LocalDate.kt

@@ -181,8 +181,6 @@ public actual class LocalDate private constructor(
     // org.threeten.bp.LocalDate#resolvePreviousValid
     /**
      * May only be called if the year and month are valid.
-     *
-     * @throws IllegalArgumentException if the result exceeds the boundaries
      */
     private fun resolvePreviousValid(year: Int, month: Int, day: Int): LocalDate {
         val newDay = min(day, month.monthLength(isLeapYear(year)))