JarCasting
JarCasting JarCasting

Lucid Time Duration for Kotlin.

A simple time duration declaration and type system for kotlin.

License

License
Categories

Categories

Kotlin Languages
GroupId

GroupId

eu.markov.kotlin.lucidtime
ArtifactId

ArtifactId

duration
Last Version

Last Version

2.0.0
Release Date

Release Date
Type

Type

jar
Description

Description

Lucid Time Duration for Kotlin.
A simple time duration declaration and type system for kotlin.
Project URL

Project URL

https://github.com/markov/lucid-time
Source Code Management

Source Code Management

https://github.com/markov/lucid-time

Download duration

Filename Size
duration-2.0.0.pom
duration-2.0.0.jar 33 KB
duration-2.0.0-sources.jar 4 KB
duration-2.0.0-javadoc.jar 91 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/eu.markov.kotlin.lucidtime/duration/ -->
<dependency>
    <groupId>eu.markov.kotlin.lucidtime</groupId>
    <artifactId>duration</artifactId>
    <version>2.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/eu.markov.kotlin.lucidtime/duration/
implementation 'eu.markov.kotlin.lucidtime:duration:2.0.0'
// https://jarcasting.com/artifacts/eu.markov.kotlin.lucidtime/duration/
implementation ("eu.markov.kotlin.lucidtime:duration:2.0.0")
'eu.markov.kotlin.lucidtime:duration:jar:2.0.0'
<dependency org="eu.markov.kotlin.lucidtime" name="duration" rev="2.0.0">
  <artifact name="duration" type="jar" />
</dependency>
@Grapes(
@Grab(group='eu.markov.kotlin.lucidtime', module='duration', version='2.0.0')
)
libraryDependencies += "eu.markov.kotlin.lucidtime" % "duration" % "2.0.0"
[eu.markov.kotlin.lucidtime/duration "2.0.0"]

Dependencies

runtime (1)

Group / Artifact Type Version
org.jetbrains.kotlin : kotlin-stdlib-jdk7 jar 1.3.10

Project Modules

There are no modules declared in this project.

Lucid Time for Kotlin

build status

The goal of this project is to make working with time durations in Kotlin simpler.

Usage

Add it to your gradle dependencies.

dependencies {
    implementation("eu.markov.kotlin.lucidtime:duration:2.0.0")
}

The main purpose is to make declaring time literals in code very concise and very close to the natural English language.

val soon = Random.nextDouble(52.0).weeks
val threeMin = 3.minutes
val anHourAndAHalf: Duration = 1.5.hours
val aLittleLonger: Duration = anHourAndAHalf + threeMin
val aLittleLongerMillis: Long = notQuiteAsLong.toMillis
val aWeekAndAHalfInMinutes: Long = 1.5.weeks.toMinutes

At the same time this library aims to keep guarantees when you compare durations from across the different types it exposes.

assertTrue(59.minutes < 1.hour)
assertTrue(60.minutes == 1.hour)
assertTrue(61.minutes > 1.hour)

All insntances are immutable and the implementation ofequals() and hashCode() makes them safe to use as keys in maps.

val map = mapOf(1.hour to "an hour")
assertEquals("an hour", map[60.minutes])

The main goal when writing this code was to replace APIs using Java's TimeUnit like:

fun delayBy(amount: Long, unit: TimeUnit) {...}

delayBy(150, TimeUnit.SECONDS)

And allow for simpler APIs like:

fun delayBy(amount: Duration) {...}

delayBy(150.seconds)
delayBy(2.5.minutes)
delayBy(2.minutes + 30.seconds)

As well as declaring constants like:

val OLD_30_SECONDS_IN_MILLIS: Long = TimeUnit.SECONDS.toMillis(30)
val NEW_30_SECONDS_IN_MILLIS: Long = 30.seconds.toMillis

License

Copyright 2018 Gesh Markov

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Versions

Version
2.0.0
1.0.0