Skip to content

Upgrading org.jetbrains.kotlinx:kotlinx-datetime 0.6 to 0.7

Breaking0.6.2 → 0.7.1-0.6.x-compatBreaking7New3Fixed5

Full comparisonBack to org.jetbrains.kotlinx:kotlinx-datetime
BreakingUpgrade verdict

7 breaking changes.

In plain terms
  • Remove kotlinx.datetime.Instant and kotlinx.datetime.Clock in favor of kotlin.time.Instant.
  • Rename dayOfMonth to day, monthNumber to month.
  • Make DayOfWeek and Month no longer type aliases to java.time.DayOfWeek and java.time.Month.
  • Add DateTimeFormat-based KSerializer implementations for datetime entities, and change the default serializers to be based on toString/parse pairs.
Must act Top 3 of 7 that need code or config changes

What you must change

Breaking7
Remove kotlinx.datetime.Instant and kotlinx.datetime.Clock in favor of kotlin.time.Instant.
kotlinx.datetime.Instantkotlinx.datetime.Clockkotlin.time.Instant
0.7.0GitHub ReleaseOriginalView source
Rename dayOfMonth to day, monthNumber to month.
dayOfMonthdaymonthNumbermonth
0.7.0GitHub ReleaseOriginalView source
Make DayOfWeek and Month no longer type aliases to java.time.DayOfWeek and java.time.Month.
DayOfWeekMonthjava.time.DayOfWeekjava.time.Month
0.7.0GitHub ReleaseOriginalView source
Add DateTimeFormat-based KSerializer implementations for datetime entities, and change the default serializers to be based on toString/parse pairs.
DateTimeFormatKSerializertoStringparse
0.7.0GitHub ReleaseOriginalView source
Unify the range of admissible LocalDate and LocalDateTime values on all platforms.
LocalDateLocalDateTime
0.7.0GitHub ReleaseOriginalView source
Make "UTC" and not "Z" be the timezone identifier for TimeZone.UTC.
"UTC""Z"TimeZone.UTC
0.7.0GitHub ReleaseOriginalView source
Accept "z" in TimeZone.of, with the same meaning as "Z".
"z"TimeZone.of"Z"
0.7.0GitHub ReleaseOriginalView source