JarCasting
JarCasting JarCasting

net.thimmwork:time-intervals

datatypes for intervals of Java.time classes

License

License
Categories

Categories

Net
GroupId

GroupId

net.thimmwork
ArtifactId

ArtifactId

time-intervals
Last Version

Last Version

0.2.0
Release Date

Release Date
Type

Type

jar
Description

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
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/net.thimmwork/time-intervals/ -->
<dependency>
    <groupId>net.thimmwork</groupId>
    <artifactId>time-intervals</artifactId>
    <version>0.2.0</version>
</dependency>
// https://jarcasting.com/artifacts/net.thimmwork/time-intervals/
implementation 'net.thimmwork:time-intervals:0.2.0'
// https://jarcasting.com/artifacts/net.thimmwork/time-intervals/
implementation ("net.thimmwork:time-intervals:0.2.0")
'net.thimmwork:time-intervals:jar:0.2.0'
<dependency org="net.thimmwork" name="time-intervals" rev="0.2.0">
  <artifact name="time-intervals" type="jar" />
</dependency>
@Grapes(
@Grab(group='net.thimmwork', module='time-intervals', version='0.2.0')
)
libraryDependencies += "net.thimmwork" % "time-intervals" % "0.2.0"
[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.

Build Status

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
0.1.0