The KIT

• Date Calculators: JDK implementation, Joda Time implementation, JDK8 implementation
• The FX Calc for handling Currencies and Rates within the Foreign Exchange business
• The Utils package for a bunch of very useful classes for Pair, Triplet, BigDecimal, Average, Standard Deviations, Console Menu, Self Caching Collections, etc see implementation
• The Utils Report package for creating simple ASCII Tabular reports, see here
• The Utils Excel package for reading and creating simple Excel spreadsheet with Apache POI, see here

Getting Started

DateCalc comes in 3 different implementations, both run on JDK 1.8 or higher :

• The vanilla JDK implementation has no external dependencies.
• The Joda Time implementation , which depends on the Joda Time library (we recommend using this one).
• The JDK8 implementation , which obviously is compiled with JDK8 and makes use of the new LocalDate.

Maven

If you're using Maven, setup is easy, as DateCalc is in the Maven Central Repository.

To use the JDK Version:

                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-common</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-jdk</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                

To use the JODA Version (recommended):

                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-common</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-joda</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                

To use the JDK8 Version:

                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-common</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                    <dependency>
                    <groupId>net.objectlab.kit</groupId>
                    <artifactId>datecalc-jdk8</artifactId>
                    <version>1.4.1</version>
                    </dependency>
                

Download the Jars

If you are not using Maven, you can download the jars here .

Date Calculations? What is that?

Apart from the very basic "add days" features, most business have to deal with Holidays and what to do when a calculated day falls on a holiday . This library does not attempt to create or guess the holidays, we all know that some bank holidays can be decided at a moment's notice in some markets. All financial institutions or big business will have their own official list of 'holidays' anyway.

Furthermore, "weekends" also need to be handled and some market have a different week to the conventional Monday -> Friday, our library provides you with full flexibility to design a Working Week.

As such a Non-working Day can be a holiday or a 'weekend'. Also note that CurrencyPairs have a specialised calculator as the rules can be 'weird'. See for more info .

Ok, what algorithm for handling a holiday do you support?

At the moment, we support the following 6 algorithms:

1. Do Nothing , i.e. leave the date as-is, even if it is a non-working day.
2. Forward , if the date is a non-working day, move forward to the next working day.
3. Backward , if the date is a non-working day, move backward to the previous working day.
4. Modified Following , if the date is a non-working day, move forward to the next working day, UNLESS it crosses over a new month, in which case we revert to find the last working day of the current month.
5. Modified Preceeding , if the date is a non-working day, move backward to the previous working day, UNLESS it crosses over a new month, in which case we revert to find the next working day of the current month.
6. ForwardUnlessNegative (new with v1.1.0), acts like a Forward algo unless the increment is negative, in which case it behaves like Backward.

See this page for some examples .

Main interfaces

The main interfaces are:

• DateCalculator for all Date calculations.
• PeriodCountCalculator for all day, month and year diff calculations.
• IMMDateCalculator for all IMM calculations (International Money Market).

Here are the examples of how to get a DateCalculator "forward" for the "UK" holidays (if you have registered the holidays). The WorkingWeek is Mon-Fri by default.

Using Joda CurrencyDateCalculator

Using Joda CurrencyDateCalculator with Builder

Using Joda Time LocalDate

Using JDK Calendar

Using JDK8 LocalDate

Using Util Total

Using Util Average

Using Util WeightedAverage

Using Util Pair