Don't hyphenate ISO 8601 when used as a compound adjective

Author: dkhalanskyjb

README.md

@@ -175,7 +175,7 @@ To convert back, use the companion object function `Instant.fromEpochMillisecond
 ### Converting instant and local date/time to and from the ISO 8601 string
 
 `Instant`, `LocalDateTime`, `LocalDate` and `LocalTime` provide shortcuts for
-parsing and formatting them using the extended ISO-8601 format.
+parsing and formatting them using the extended ISO 8601 format.
 The `toString()` function is used to convert the value to a string in that format, and 
 the `parse` function in companion object is used to parse a string representation back. 
 
@@ -201,7 +201,7 @@ LocalTime.parse("12:0:03.999") // fails with an IllegalArgumentException
 
 ### Working with other string formats
 
-When some data needs to be formatted in some format other than ISO-8601, one
+When some data needs to be formatted in some format other than ISO 8601, one
 can define their own format or use some of the predefined ones:
 
 ```kotlin

core/common/src/DateTimePeriod.kt

@@ -96,7 +96,7 @@ public sealed class DateTimePeriod {
         totalMonths <= 0 && days <= 0 && totalNanoseconds <= 0 && (totalMonths or days != 0 || totalNanoseconds != 0L)
 
     /**
-     * Converts this period to the ISO-8601 string representation for durations, for example, `P2M1DT3H`.
+     * Converts this period to the ISO 8601 string representation for durations, for example, `P2M1DT3H`.
      *
      * @see DateTimePeriod.parse
      */
@@ -143,12 +143,12 @@ public sealed class DateTimePeriod {
 
     public companion object {
         /**
-         * Parses a ISO-8601 duration string as a [DateTimePeriod].
+         * Parses a ISO 8601 duration string as a [DateTimePeriod].
          * If the time components are absent or equal to zero, returns a [DatePeriod].
          *
          * Additionally, we support the `W` signifier to represent weeks.
          *
-         * Examples of durations in the ISO-8601 format:
+         * Examples of durations in the ISO 8601 format:
          * - `P1Y40D` is one year and 40 days
          * - `-P1DT1H` is minus (one day and one hour)
          * - `P1DT-1H` is one day minus one hour
@@ -372,7 +372,7 @@ public class DatePeriod internal constructor(
 
     public companion object {
         /**
-         * Parses the ISO-8601 duration representation as a [DatePeriod], for example, `P1Y2M30D`.
+         * Parses the ISO 8601 duration representation as a [DatePeriod], for example, `P1Y2M30D`.
          *
          * This function is equivalent to [DateTimePeriod.parse], but will fail if any of the time components are not
          * zero.

core/common/src/DayOfWeek.kt

@@ -22,12 +22,12 @@ public expect enum class DayOfWeek {
 }
 
 /**
- * The ISO-8601 number of the given day of the week. Monday is 1, Sunday is 7.
+ * The ISO 8601 number of the given day of the week. Monday is 1, Sunday is 7.
  */
 public val DayOfWeek.isoDayNumber: Int get() = ordinal + 1
 
 /**
- * Returns the [DayOfWeek] instance for the given ISO-8601 week day number. Monday is 1, Sunday is 7.
+ * Returns the [DayOfWeek] instance for the given ISO 8601 week day number. Monday is 1, Sunday is 7.
  */
 public fun DayOfWeek(isoDayNumber: Int): DayOfWeek {
     require(isoDayNumber in 1..7)

core/common/src/Instant.kt

@@ -240,7 +240,7 @@ public expect class Instant : Comparable<Instant> {
     public override operator fun compareTo(other: Instant): Int
 
     /**
-     * Converts this instant to the ISO-8601 string representation; for example, `2023-01-02T23:40:57.120Z`
+     * Converts this instant to the ISO 8601 string representation; for example, `2023-01-02T23:40:57.120Z`
      *
      * The representation uses the UTC-SLS time scale, instead of UTC.
      * In practice, this means that leap second handling will not be readjusted to the UTC.

core/common/src/LocalDate.kt

@@ -198,7 +198,7 @@ public expect class LocalDate : Comparable<LocalDate> {
     public override fun compareTo(other: LocalDate): Int
 
     /**
-     * Converts this date to the extended ISO-8601 string representation.
+     * Converts this date to the extended ISO 8601 string representation.
      *
      * @see Formats.ISO for the format details.
      * @see parse for the dual operation: obtaining [LocalDate] from a string.

core/common/src/LocalTime.kt

@@ -262,7 +262,7 @@ public expect class LocalTime : Comparable<LocalTime> {
     public override operator fun compareTo(other: LocalTime): Int
 
     /**
-     * Converts this time value to the extended ISO-8601 string representation.
+     * Converts this time value to the extended ISO 8601 string representation.
      *
      * For readability, if the time represents a round minute (without seconds or fractional seconds),
      * the string representation will not include seconds. Also, fractions of seconds will add trailing zeros to

core/common/src/UtcOffset.kt

@@ -156,7 +156,7 @@ public expect class UtcOffset {
     }
 
     /**
-     * Converts this UTC offset to the extended ISO-8601 string representation; for example, `+02:30` or `Z`.
+     * Converts this UTC offset to the extended ISO 8601 string representation; for example, `+02:30` or `Z`.
      *
      * @see Formats.ISO for the format details.
      * @see parse for the dual operation: obtaining [UtcOffset] from a string.

core/common/src/serializers/DateTimePeriodSerializers.kt

@@ -71,7 +71,7 @@ public object DateTimePeriodComponentSerializer: KSerializer<DateTimePeriod> {
 }
 
 /**
- * A serializer for [DateTimePeriod] that represents it as an ISO-8601 duration string.
+ * A serializer for [DateTimePeriod] that represents it as an ISO 8601 duration string.
  *
  * JSON example: `"P1DT-1H"`
  *
@@ -154,7 +154,7 @@ public object DatePeriodComponentSerializer: KSerializer<DatePeriod> {
 }
 
 /**
- * A serializer for [DatePeriod] that represents it as an ISO-8601 duration string.
+ * A serializer for [DatePeriod] that represents it as an ISO 8601 duration string.
  *
  * Deserializes the time components as well, as long as they are zero.
  *

core/common/src/serializers/InstantSerializers.kt

@@ -11,7 +11,7 @@ import kotlinx.serialization.descriptors.*
 import kotlinx.serialization.encoding.*
 
 /**
- * A serializer for [Instant] that uses the ISO-8601 representation.
+ * A serializer for [Instant] that uses the ISO 8601 representation.
  *
  * JSON example: `"2020-12-09T09:16:56.000124Z"`
  *

core/common/src/serializers/LocalDateSerializers.kt

@@ -11,7 +11,7 @@ import kotlinx.serialization.descriptors.*
 import kotlinx.serialization.encoding.*
 
 /**
- * A serializer for [LocalDate] that uses the ISO-8601 representation.
+ * A serializer for [LocalDate] that uses the ISO 8601 representation.
  *
  * JSON example: `"2020-01-01"`
  *

core/common/src/serializers/LocalDateTimeSerializers.kt

@@ -11,7 +11,7 @@ import kotlinx.serialization.descriptors.*
 import kotlinx.serialization.encoding.*
 
 /**
- * A serializer for [LocalDateTime] that uses the ISO-8601 representation.
+ * A serializer for [LocalDateTime] that uses the ISO 8601 representation.
  *
  * JSON example: `"2007-12-31T23:59:01"`
  *

core/common/src/serializers/LocalTimeSerializers.kt

@@ -11,7 +11,7 @@ import kotlinx.serialization.descriptors.*
 import kotlinx.serialization.encoding.*
 
 /**
- * A serializer for [LocalTime] that uses the ISO-8601 representation.
+ * A serializer for [LocalTime] that uses the ISO 8601 representation.
  *
  * JSON example: `"12:01:03.999"`
  *

core/common/src/serializers/TimeZoneSerializers.kt

@@ -54,7 +54,7 @@ public object FixedOffsetTimeZoneSerializer: KSerializer<FixedOffsetTimeZone> {
 }
 
 /**
- * A serializer for [UtcOffset] that uses the extended ISO-8601 representation.
+ * A serializer for [UtcOffset] that uses the extended ISO 8601 representation.
  *
  * JSON example: `"+02:00"`
  *

serialization/common/test/DateTimePeriodSerializationTest.kt

@@ -117,7 +117,7 @@ class DateTimePeriodSerializationTest {
 
     @Test
     fun testDefaultSerializers() {
-        // Check that they behave the same as the ISO-8601 serializers
+        // Check that they behave the same as the ISO 8601 serializers
         dateTimePeriodIso8601Serialization(Json.serializersModule.serializer())
         datePeriodIso8601Serialization(Json.serializersModule.serializer(), Json.serializersModule.serializer())
     }

serialization/common/test/InstantSerializationTest.kt

@@ -63,7 +63,7 @@ class InstantSerializationTest {
 
     @Test
     fun testDefaultSerializers() {
-        // should be the same as the ISO-8601
+        // should be the same as the ISO 8601
         iso8601Serialization(Json.serializersModule.serializer())
     }
-}
+}

serialization/common/test/LocalDateSerializationTest.kt

@@ -66,7 +66,7 @@ class LocalDateSerializationTest {
 
     @Test
     fun testDefaultSerializers() {
-        // should be the same as the ISO-8601
+        // should be the same as the ISO 8601
         iso8601Serialization(Json.serializersModule.serializer())
     }
 

serialization/common/test/LocalDateTimeSerializationTest.kt

@@ -79,7 +79,7 @@ class LocalDateTimeSerializationTest {
 
     @Test
     fun testDefaultSerializers() {
-        // should be the same as the ISO-8601
+        // should be the same as the ISO 8601
         iso8601Serialization(Json.serializersModule.serializer())
     }
 }

serialization/common/test/LocalTimeSerializationTest.kt

@@ -69,7 +69,7 @@ class LocalTimeSerializationTest {
 
     @Test
     fun testDefaultSerializers() {
-        // should be the same as the ISO-8601
+        // should be the same as the ISO 8601
         iso8601Serialization(Json.serializersModule.serializer())
     }
 }