kotlinx-datetime

• Introduce the widely requested API for locale-invariant parsing and formatting (#343)
• Completely overhaul the KDoc-based documentation (#347)
• Breaking change: forbid parsing Instant values without the second-of-minute component on the JVM and JS, fixing inconsistency with Native (#369)
• Breaking change: use the fully qualified name of classes in the JSON serializers (#308)
• Fix Proguard emitting warning about missing kotlinx-serialization classes when serialization is not used (#336)
• Reimplement the timezone database handling for Native targets from scratch (#286, #327)
• Support Android NDK targets (#344)
• Small tweaks and fixes.

Changelog relative to version 0.6.0-RC.2

• Completely overhaul the KDoc-based documentation (#347)
• Breaking change: forbid parsing Instant values without the second-of-minute component on the JVM and JS, fixing inconsistency with Native (#369)
• Improve error descriptiveness in some cases (#360, #371)
• Remove stat usages to comply with Apple's new publishing requirements (#385)
• Fix parsing of formats where optional is directly between numbers (#362)
• Forbid empty and duplicate month, day-of-week, and AM/PM marker names in datetime formats (#362)

New Contributors

• @whyoleg made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/323
• @qwwdfsad made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/308
• @shanshin made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/380

Full Changelog: https://github.com/Kotlin/kotlinx-datetime/compare/v0.5.0...v0.6.0

• Support Android NDK targets (#344)
• Ensure ABI compatibility with v0.5.0 (#357)

• Introduce the widely requested API for locale-invariant parsing and formatting (#343)
• Breaking change: use the fully qualified name of classes in the JSON serializers (#308)
• Fix Proguard emitting warning about missing kotlinx-serialization classes when serialization is not used (#336)
• Reimplement the timezone database handling for Native targets from scratch (#286, #327)

• Update Kotlin dependency to 1.9.21, kotlinx.serialization to 1.6.2
• Add support of Wasm-Js target through Js interop with the same js-joda library as in Js (#315)
• Prevent secondary outputs of Java 9 compilation getting packed into jar (#305)

New Contributors

• @FenstonSingel made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/318
• @igoriakovlev made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/315

Full Changelog: https://github.com/Kotlin/kotlinx-datetime/compare/v0.4.1...v0.5.0

• Update Kotlin dependency to 1.8.21, kotlinx.serialization to 1.5.1
• Support more Kotlin/Native targets: linuxArm64, linuxArm32Hfp, watchosDeviceArm64
• Implement comparable time marks in a time source returned by Clock.asTimeSource() (#271)
• Deprecate Instant and LocalDate arithmetic operations (plus and minus) taking DateTimeUnit without a number of units (#247)
• Fix adding small Duration to large Instant on JS and Native (#264)

New Contributors

• @lukellmann made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/264
• @NinoDLC made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/252
• @MarkCMann made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/288
• @joffrey-bion made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/292
• @cmota made their first contribution in https://github.com/Kotlin/kotlinx-datetime/pull/278

Full Changelog: https://github.com/Kotlin/kotlinx-datetime/compare/v0.4.0...v0.4.1

• Add the LocalTime class for representing time-of-day (#57). Thank you, @bishiboosh!
• Provide LocalTime#toSecondOfDay, LocalTime.fromSecondOfDay, and various other functions for compact representation of LocalTime (#204). Thank you, @vanniktech!
• Provide LocalDate#toEpochDays, LocalDate.fromEpochDays for representing a LocalDate as a single number (#214).
• Rename Clock.todayAt to Clock.todayIn for naming consistency (#206).
• Update the Kotlin dependency to 1.7.0.

Changes

• Just updated Kotlin dependency to 1.7.0-Beta and kotlinx.serialization to 1.3.2

Features

• Update Kotlin dependency to 1.6.0 and remove ExperimentalTime from API involving Duration which became stable (#156)
• Add an explicit module-info descriptor to JVM variant of the library (#135)
• kotlinx.datetime.Instant conversions to and from JS Date (#170).

Fixes

• Fixed a crash in desugared code on Android when trying to construct time zones with some specific identifiers (149)

Features

• Added iosSimulatorArm64, watchosSimulatorArm64, tvosSimulatorArm64, macosArm64 target support (141, 144).

Changes

• ZoneOffset was replaced by two other classes: FixedOffsetTimeZone, which represents a time zone with a fixed offset, and UtcOffset, which represents just the UTC offset (PR#125).
• The DayBased and MonthBased subclasses of DateTimeUnit.DateBased are now accessed as DateTimeUnit.DayBased and DateTimeUnit.MonthBased as opposed to DateTimeUnit.DateBased.DayBased and DateTimeUnit.DateBased.MonthBased respectively (PR#131).

Fixes

• Fixed the library being incompatible with kotlinx.serialization 1.2.0 and above (#118).

Features

• watchosX64 target support. In practice, this means the ability to run projects that depend on this library in the iOS Simulator for Apple Watch.

Fixes

• Fix TimeZone.currentSystemDefault() crashing on Darwin if the resulting time zone is not listed among TimeZone.knownTimeZoneIdentifiers (#94)

Features

• kotlinx-serialization support (#37)
• Normalization of DateTimePeriod components, meaning that periods that are semantically equivalent are considered equal (#81)
• Instant can now be parsed from an ISO-8601 string with an offset other than Z (#56)

Fixes

• Fix a crash when getting the current time on iOS 9 (#52)
• Wrong answers in some cases when adding date-based units to instants on Darwin and Windows (#51)

Features

• Zone-agnostic time-based arithmetic on Instants, e.g. Instant.plus(value, DateTimeUnit.TimeBased)
• Add Instant.fromEpochSeconds(epochSeconds: Long, nanosecondAdjustment: Int) construction function
• Introduce minus operations complementary to existing plus arithmetic operations (#42)

The initial release, contains the basic types and operations to work with dates and times.