net.thimmwork:time-intervals

datatypes for intervals of Java.time classes

License	Apache License, Version 2.0
Categories	Net
GroupId	net.thimmwork
ArtifactId	time-intervals
Last Version	0.2.0
Release Date	Jan 26, 2019
Type	jar
Description	datatypes for intervals of Java.time classes

Download time-intervals

Filename	Size
time-intervals-0.2.0.pom
time-intervals-0.2.0.jar	19 KB
time-intervals-0.2.0-sources.jar	5 KB
time-intervals-0.2.0-javadoc.jar	41 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/net.thimmwork/time-intervals/ -->
<dependency>
    <groupId>net.thimmwork</groupId>
    <artifactId>time-intervals</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/net.thimmwork/time-intervals/
implementation 'net.thimmwork:time-intervals:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.thimmwork/time-intervals/
implementation ("net.thimmwork:time-intervals:0.2.0")

Apache Buildr

'net.thimmwork:time-intervals:jar:0.2.0'

Apache Ivy

<dependency org="net.thimmwork" name="time-intervals" rev="0.2.0">
  <artifact name="time-intervals" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.thimmwork', module='time-intervals', version='0.2.0')
)

Scala SBT

libraryDependencies += "net.thimmwork" % "time-intervals" % "0.2.0"

Leiningen

[net.thimmwork/time-intervals "0.2.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.google.guava : guava	jar	26.0-jre
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.2.30

test (2)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-test-junit	jar	1.2.30
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Time Intervals

This library provides data types for intervals of java.time classes.

Conventions

LocalDateIntervals are closed, which means that the year 2018 is represented by a LocalDateInterval starting on 2018-01-01 and ending on 2018-12-31.

Instant and DateTimeIntervals are closed-open, which means that the year 2018 is represented by 2018-01-01T:00:00:00 to 2019-01-01T00:00:00 in the respective time zone.

There are constants for Infinity which are

• 1970-01-01 - 4000-12-31 for LocalDate
• 1970-01-01 00:00:00 UTC - 4000-12-31 00:00:00 UTC

respectively. This makes calculations and usage a lot easier, because unbound intervals are treated just like bound ones and fields are always non-null.

To ensure intervals from user input or external sources are within these bounds, use the normalize() function.

Serialization

As of now, serialization via Jackson is supported. Other means may follow in the near future. Feel free to leave a feature request.

Jackson

A module that provides JSON de/serialization via Jackson is provided by the artifact

    <dependency>
        <groupId>net.thimmwork</groupId>
        <artifactId>time-intervals-jackson</artifactId>
    </dependency>

Register it to your ObjectMapper instance like this:

    objectMapper.registerModule(TimeIntervalsJackson.MODULE)

Versions

Version
0.2.0 Jan 26, 2019
0.1.0 Apr 6, 2018