fluid-time

Additions for Kotlin's date & time library kotlinx-datetime.

kotlinx-datetime is very early stage and not as actively developed as other official libraries. This library keeps adding missing pieces until the official library catches up.

Installation

build.gradle.kts:

dependencies {
	implementation("io.fluidsonic.time:fluid-time:0.12.0")
}

Additions

• LocalTime - similar to the existing LocalDate and LocalDateTime
• LocalTime.midnight - 00:00
• LocalTime.atDate(LocalDate): LocalDateTime - create LocalDateTime from LocalDate and LocalTime
• LocalDate.atTime(LocalTime): LocalDateTime - create LocalDateTime from LocalDate and LocalTime
• LocalDateTime.time - returns its time components as LocalTime
• Timestamp - alias of Instant for those who prefer that name (Discussion)
• (LocalDate|LocalDateTime|LocalTime|Timestamp).parseOrNull(String) - like parse() but returns null instead of throwing
• TimeZone.ofOrNull(String) - like of() but returns null instead of throwing
• (LocalDate|LocalDateTime|LocalTime|TimeStamp|TimeZone)Serializer - for use with kotlinx-serialization
• Timestamp.toLocalDate(TimeZone) - shortcut for .toLocalDateTime(timeZone).date
• Timestamp.toLocalTime(TimeZone) - shortcut for .toLocalDateTime(timeZone).time
• Timestamp.toJavaDate(): Date - converts a Timestamp to java.util.Date (JVM only)
• ManualClock - a Clock implementation suitable for unit testing
• JVM, JS and Darwin are supported. linuxX64 and mingwX64 are not supported.

Previous library

Before kotlinx-datetime was released this library has provided its own date & time implementations for JVM and Darwin. That work has been discontinued in favor of using the new official library, even if experimental, with additions provided by this reworked library. Bugfix releases will still be provided if needed.

You can still use the last previous library version 0.10.5.

License

Apache 2.0