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.14.0")
}

Additions

• Duration(days, hours, minutes, seconds, nanoseconds) – Duration factory function using components
• Duration.parse()/.parseOrNull() - parse Duration from ISO-8601 string
• DurationSerializer - kotlinx-serialization serializer for Duration
• LocalDate.atTime(LocalTime): LocalDateTime - create LocalDateTime from LocalDate and LocalTime
• LocalDateOrNull(year, month, day) - like LocalDate() but returns null instead of throwing
• LocalDateTime.time - returns its time components as LocalTime
• LocalTime - similar to the existing LocalDate and LocalDateTime
• LocalTime.midnight - 00:00
• LocalTime.atDate(LocalDate): LocalDateTime - create LocalDateTime from LocalDate and 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
• Timestamp.durationSince(Timestamp)/.durationUntil(Timestamp) - get Duration between two timestamps
• 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)
• Month.daysIn(year) - number of days in a given month and year
• Year.isLeap(year) - whether a year is a leap year
• 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