Kotlin Duration Extensions
Gradle
Groovy
repositories {
mavenCentral()
}
implementation 'com.eygraber:kotlin-duration-extensions:1.0.1'
Kotlin
repositories {
mavenCentral()
}
implementation("com.eygraber:kotlin-duration-extensions:1.0.1")
Snapshots
Snapshots can be found at the Sonatype s01 repository:
Groovy
repositories {
maven { url 'https://s01.oss.sonatype.org/content/repositories/snapshots' }
}
Kotlin
repositories {
maven(url = "https://s01.oss.sonatype.org/content/repositories/snapshots")
}
Usage
Extension properties are supplied on Int, Long, and Double to make creating a Duration simpler:
2.nanoseconds
2.microseconds
2.milliseconds
2.seconds
2.minutes
2.hours
2.days
There are also extension properties supplied on Duration to get the underlying value as a Double and as an Int:
val duration = 2.seconds
duration.inDoubleNanoseconds
duration.inDoubleMicroseconds
duration.inDoubleMilliseconds
duration.inDoubleSeconds
duration.inDoubleMinutes
duration.inDoubleHours
duration.inDoubleDays
duration.inWholeIntNanoseconds
duration.inWholeIntMicroseconds
duration.inWholeIntMilliseconds
duration.inWholeIntSeconds
duration.inWholeIntMinutes
duration.inWholeIntHours
duration.inWholeIntDays
Rationale
The Int, Long, and Double extension properties for creating a Duration have been deprecated in Kotlin 1.5.
There's been some discussion about it on the Kotlin Slack channel and the KEEP for Duration and time measurement API, and it seems unlikely that it will come back in the stdlib.
This library brings them back
In addition, the Duration properties that returned the value as a Double have been deprecated. This is because Duration is now backed by a Long.
The new way to retrieve the value as a Double is to use Duration.toDouble(DurationUnit). That can be a little verbose, so this library provides Duration.inDouble* functions.
Since a lot of existing APIs accept an Int amount of milliseconds/seconds/etc, this library also provides Duration.inWholeInt* functions.
8 Nov 7, 2022
67 Oct 3, 2022
0 Nov 3, 2021
25 Dec 27, 2022
92 Dec 23, 2022
0 Jan 20, 2022
3.4k Nov 20, 2022
35 Oct 8, 2022
51 Oct 3, 2022
23 Feb 16, 2022
48 Oct 3, 2022
2 Mar 26, 2022
50 Nov 6, 2022
82 Oct 1, 2022
3 May 27, 2021
4 Sep 11, 2021
4 Aug 11, 2022
3 Oct 26, 2022
3 Oct 27, 2021