Date4j- 日付を扱う最小限のライブラリ

原文(投稿日：2011/12/02)へのリンク

日付を扱うJavaのクラスは、 JDK1.0以来ほとんど変わっておらず、有名な問題 に悩まされてきた（例えば、1月は 0から始まる ので多くの１ズレバグの原因になっている）。このような問題に対処するために、新しいJSRが 提案されている が、まだ アルファバージョンである。それが安定するまで、多くの開発者は、 Joda Time ライブラリを使っている。これは JSR-310の参照実装の実現形態に似ている（が同じではない）。

Date4j はJavaで日付を扱う他のソリューションを提案しており、 Joda Timeとは完全に違うスコープを持っている。以下がその比較である。

一見すると Date4jはJodaの最小限のフィーチャしか提供していないように見えるが、Jodaが扱っていない2つの大きな利点がある。

まず、 Date4jの開発者は、ライブラリは理由もなしに日付を切り捨てるべきでない、と主張する 。Jodaはミリ秒の精度しかサポートしない、このことは将来も 恐らく変わらないだろう 。しかし幾つかのデータベースはもっと精度が良い。例えば、人気のあるPostgreSQLは、マイクロ秒のタイムスタンプをサポートしている。Date4j は、この正確さを維持しながらこれらの日付を処理できる。

2つ目のポイントは、日付「オーバーフロー」の問題、すなわち、ある日付にある期間を加えると次の月まで行ってしまうことである。簡単な例は、3月31日に1ヶ月加えることである。

DateTime dt = new DateTime("2011-03-31");

DateTime result = dt.plusMonths(1);

System.out.println(result.toString());

Joda Timeでこれを走らせると、4月30日になるが、これは期待した結果かもしれないが、そうでないかもしれない。

この曖昧さを認識して、 Date4jではこれを処理するのに 4つの選択肢 を提供する。

以下がこれらの場合の例である（Jodaではなく、 Date4jを使っている）

DateTime dt1 = new DateTime("2011-03-31");

DateTime result1 = dt1.plus(0,1,0,0,0,0,DayOverflow.FirstDay);

System.out.println(result1.toString());

//Prints 2011-05-01 (first of May)

		

		

DateTime dt2 = new DateTime("2011-03-31");

DateTime result2 = dt2.plus(0,1,0,0,0,0,DayOverflow.LastDay);

System.out.println(result2.toString());

//Prints 2011-04-30 (30th of April - same as Joda)

		

DateTime dt3= new DateTime("2011-03-31");

DateTime result3 = dt3.plus(0,1,0,0,0,0,DayOverflow.Abort);

System.out.println(result3.toString()); 

//Throws run time exception

DayOverflow.Spilloverオプションを以下に示す。

//Joda Time code

DateTime dt = new DateTime("2010-12-31");

DateTime result = dt.plusMonths(2);

System.out.println(result.toString());

//Prints 2011-02-28 (29th of February)



//Date4j code

DateTime dt1 = new DateTime("2010-12-31");

DateTime result1 = dt1.plus(0,2,0,0,0,0,DayOverflow.FirstDay);

System.out.println(result1.toString());

//Prints 2011-03-01 (first of March)



//Date4j code

DateTime dt2 = new DateTime("2010-12-31");

DateTime result2 = dt2.plus(0,2,0,0,0,0,DayOverflow.LastDay);

System.out.println(result2.toString());

//Prints 2011-02-28 (28th of February - Same as Joda)

		

//Date4j code

DateTime dt3= new DateTime("2010-12-31");

DateTime result3 = dt3.plus(0,2,0,0,0,0,DayOverflow.Spillover);

System.out.println(result3.toString()); 

//Prints 2011-03-02 (2nd of March)

もしあなたのアプリケーションが、データベースの日付を扱うときに高精度で、精度を維持する必要がある場合や、月を跨ぐオーバーフローを完全にコントロールしたいと思うなら、 Date4jはあなたのアプリケーションに有益なライブラリだろう。ソースコードは、ここから直接ダウンロードできる。