ここではJavaでの日付と時間の扱いについて説明します。まず最初にJavaで、（特に）事務系業務処理においてよく行うであろう処理に関するパッケージ・クラスを挙げておきます。

日付時間処理で使用するクラス
　・java.text.DateFormat
　・java.text.SimpleDateFormat
　・java.util.Date
　・java.util.Calendar
　・java.util.GregorianCalendar

　これらのクラスを使用して日付時間に関する処理をするのですが、これらクラス間の関係を把握したほうがいいと思うので、細かい説明の前にまず図示しておきます。

　Javaで日付時間を扱う基本的なクラスは Date クラスなんですが、実際に処理で使う際は Calendar クラスおよびその拡張である GregorianCalendar クラスを使うほうが多いと思います。

　Javaが扱う日付時間のもっとも基本の部分では、1970年1月1日0時0分0秒を基準としたミリ秒単位で管理しています。 Date クラスや Calendar クラス、 GregorianCalendar クラスも全てこの管理体系に基づきます。
　APIドキュメントで Date クラスのメソッドの説明を見ると、ほとんどが「推奨されていません」となっており、 Calendar クラスのメソッドで置き換えられています。

　 Calendar クラスは、いわゆる一般的なカレンダを表すクラスで、具体的な西暦、グレゴリオ暦を表すのがこれを拡張した GregorianCalendar クラスです。こちらは Calendar クラスの拡張なのでこれのメソッドは使用できますし、さらにうるう年判定などの機能を持っています。

　現バージョン（Java2 SDK SE1.4）では拡張クラスは GregorianCalendar クラスしかありませんが、そのうち日本の和暦や旧暦を扱う拡張クラスも標準で取り込まれるかもしれません（今の段階では自分で共通ルーチンのようにこれらの拡張クラスを作成する必要がありますし、それぞれの開発チームでは実際にそうしているでしょう）。

　DateFormat クラスは Date クラスと日付を表す文字列との相互変換に使います。
　SimpleDateFormat クラスは DateFormat クラスを拡張したものです。 Date クラスと日付を表す文字列との相互変換時に書式スタイルというものを使うのですが、こちらのクラスでは任意の書式スタイルを使えます。

　日付時間に関するクラスについて、主なメソッドを説明します。

　メソッドの説明に先立ち、 new 演算子で GregorianCalendar インスタンスを生成するためのコンストラクタを説明しておきます。

　add メソッドで時間領域を指定することにより、例えば何日後、何日前、何分後、何分前、といった計算をすることが出来ます。
　しかしある日付時間と別の日付時間の差を求めるメソッドがありません。時間差の計算であれば、 getTimeInMillis メソッドで long 型のミリ秒単位の値を取得すれば可能です。 long 同士で引き算を行い、結果を setTimeInMillis メソッドでGregorianCalendar インスタンスに設定してあげると分秒マイクロ秒単位の時間差が取れます。

　上記メソッドの引数に指定する int 型の時間領域は、 Calendar クラスで定数として定義されています。つまり Calendar クラスで public final で定義されたフィールドということです。指定するときは Calendar.定数名 としください。

　例えば月名の定数を使う場合を、例題を挙げて説明しましょう。

　ある販売管理システムで、受注日（Order Date）から対応する会計年度（Fiscal Year）を決めるとしましょう。3月決算の会社なら2003年3月の会計年度は2003年度ではなく、2002年度になります。つまり受注日の月が3月以前か、4月以降かで判断します。
　 GregorianCalendar 型のw_odr_dteに受注日が入っているとするとこの判断処理は、

　if　(w_odr_dte.get(Calendar.MONTH)　>　2)
　　{
　　　w_fiscal_yy　=　w_odr_dte.get(Calendar.YEAR);
　　}
　else
　　{
　　　w_fiscal_yy　=　w_odr_dte.get(Calendar.YEAR)　-　1;
　　}

になります。しかしこれだと if の条件式が.get(Calendar.MONTH)　>　2 となり、直感的に、3月か判定している、ということが分かり難くなります。そのため月名定数を使って

　if　(w_odr_dte.get(Calendar.MONTH)　>　Calendar.MARCH)
　　{
　　　w_fiscal_yy　=　w_odr_dte.get(Calendar.YEAR);
　　}
　else
　　{
　　　w_fiscal_yy　=　w_odr_dte.get(Calendar.YEAR)　-　1;
　　}

としたほうがいいでしょう。


　時間差の計算をするときに getTimeInMillis メソッドで long 型のミリ秒単位の値を取得し、 long 同士で引き算を行って結果を setTimeInMillis メソッドで GregorianCalendar インスタンスに設定してあげるとよい、と書きました。
　しかし若干の注意点があります。分以下なら問題ないのですが時間以上の時間差計算をすると、 GregorianCalendar インスタンスに設定したときにGMTとの時差も入ってしまうので、デフォルトの地域が Asia/Tokyo だと9時間ずれてしまいます（ GregorianCalendar から getTime や get で取り出したときに、時間にGMTからの時差9時間が足されている）。

　そのため時間差用の GregorianCalendar インスタンスを生成するときは、 TimeZone を指定したコンストラクタを使ってください。
　 TimeZone を使うためには次のクラスもインポートします。
　・java.util.TimeZone
　時間差用の GregorianCalendar インスタンス生成手順は次のようになります。

　TimeZone w_tzone = null; // TimeZone型変数の定義
　GregorianCalendar w_gclndr = null; // GregorianCalendar型変数の定義

　w_tzone = TimeZone.getDefault(); // デフォルトのTimeZone取得
　w_tzone.setRawOffset(0); // TimeZoneにGMTからの時差0ミリ秒を設定
　w_gclndr = new GregorianCalendar(w_tzone); // 指定した時差を持つGregorianCalendarの生成

　ただしこの GregorianCalendar から getTime で Date インスタンスを取得して format すると、やはりデフォルトの地域に基づく時差が考慮されてしまうので、 get メソッドで個別に時間領域を取り出したほうがいいです。
　こうしておけば GregorianCalendar に設定した時間差は、1970年1月1日0時0分0秒を基準としたミリ秒単位の日付時刻と解釈されるので、31日までなら時間差を日時分秒ミリ秒に変換して表示できます（31日を過ぎると2月になってしまうので）。

　これについては実際に自分で、ある日時に対して MONTH 、 DAY_OF_MONTH 、 HOUR などに add でいろいろな値を加減算し、結果の日時と元の日時の差を求めて表示するプログラムを作って確認してみてください。

　必要なのが日差、日数計算なら、計算に使う日付から get(DAY_OF_YEAR) で年内通算日を取得して計算するといいでしょう。ただし年を跨るときはうるう年判定によって、計算結果が負のときに365を足すか366を足すかが変わってくるので注意してください。
　例えば12月20日から翌年1月10までの日数は、うるう年に関係なく21日です。
　2002年12月20日の DAY_OF_YEAR は354日で、2003年1月10日の DAY_OF_YEAR は10日です。日数はTO日付 - FROM日付ですが、数値が逆転するので年を跨るときはTO日付に1年分の日数、365を足してあげます。そうすると10 + 365 - 354 = 21日となります。
　しかし2000年12月20日から2001年1月10日だと2000年がうるう年なので DAY_OF_YEAR は355日、2001年1月10日の DAY_OF_YEAR は10日なので先の計算式だと日数は20日になってしまいます。うるう年のときはTO日付には365ではなく366を足さないといけない、ということです。

　 DateFormat クラスは日付時刻に関する書式を定義しています。これを拡張したものに SimpleDateFormat クラスがあり、こちらを使うと任意の書式を設定できます（2003年1月7日 と日本語表示するなど）。
　先に標準の DateFormat クラスについて説明しておきます。

　 DateFormat クラスをインスタンス化する際のメソッドの、getDateInstance や getDateTimeInstance の違いについて説明します。
　この二つを例に説明すると、 format メソッドの結果文字列や parse メソッドの元文字列に時刻まで含むか否か、ということになります。
　地域が Asia/Tokyo （日本になります）だと標準の書式スタイルは DateFormat.MEDIUM になり、
　日付は yyyy/MM/dd
　時刻は H:mm:ss
　日付時刻は yyyy/MM/dd H:mm:ss
となります。 parse メソッドで入力文字列を解析して Date 型のデータを取得するとき、入力文字列がこの形式になっていないといけません。

　 getDateInstance メソッドで インスタンス化した場合は日付の部分のみ解析されます。例えば、"2003/1/7"はもちろん問題ありませんし、"2003/1/7 12:34:56"と時刻まで指定しても日付部分の"2003/1/7"のみ解析されるので大丈夫です。

　それに対して getDateTimeInstance メソッドで インスタンス化した場合は、入力文字列に時刻まで含まれていないといけません。今度は"2003/1/7"と日付のみ指定すると ParseException が発生します。

　逆に format メソッドで Date 型を文字列に変換するときは getDateInstance か getDateTimeInstance かによって、上記書式スタイルに合わせて変換する際に日付のみか時刻まで変換するかが変わります。

　SimpleDateFormat の場合はメソッドではなく、 new 演算子でコンストラクタを使用してインスタンスを生成してください。コンストラクタの引数に書式パターン文字列を指定します。

　年月日、時分秒などの数値のとき、書式パターン文字を1文字で指定したときは頭の0は省略されます。そうでない場合は書式パターン文字数に合うように頭に0が付加されます。
　例えば "H" とすると午前2時は 2 、午後4時は 16 になりますが、 "HH" とすると午前2時は 02 、午後4時は 16 になります。

　書式パターン文字以外の文字は、そのまま表示されます。 "yyyy-MM-dd" という書式パターンを指定して2003年1月10日を format すると、 "2003-01-10" と変換されます。
　書式パターン文字に該当する文字をそのまま使いたい場合はその文字列部分を ' で囲ってください。囲まれた部分は書式パターン文字とは解釈されずにそのまま表示になります。あまり意味が無いんですが例えば "Mamy" と表示したい場合、 "'Mamy' yy/MM a K:m" と指定して 2003年2月20日午前10時42分 を format すると、 "Mamy 03/02 AM 10:42" と変換されます。

　例えば日本語で時間まで表示したいなら、"yyyy年MM月dd日 HH時mm分" や "yyyy年M月d日 H時m分" という書式パターン文字列を指定することができます。

　最後に SimpleDateFormat クラスのメソッドを一つ説明しておきます。日付や時刻の表示形式よって個別にインスタンス化するのではなく、一つのインスタンスを使い回して日付表示のとき、時刻表示のときなどで書式パターンを変更するときに使えるメソッドです。

　入力画面に日付を入力するテキストボックスがあり、その内容をチェックする処理のサンプルコーディングはこうなります。サンプルは DateFormat を使い、標準の書式パターンで日付のみ入力、という場合の処理です。

　String　　　　　　　　　 w_in_dat; // 画面からのパラメータ
　DateFormat　　　　　 w_dfmt;
　GregorianCalendar　w_gclndr; // 変換後の日付データ

　if (request.getParameter("Date1") == null)
　　{}
　else
　　{
　　　w_in_dat = request.getParameter("Date1");
　　　w_dfmt = DateFormat.getDateInstance();
　　　w_gclndr = new GregorianCalendar();
　　　try
　　　　{
　　　　　w_gclndr.setTime(w_dfmt.parse(w_in_dat);
　　　　　// 日付取得後の処理
　　　　}
　　　catch(ParseException wl_excp)
　　　　{
　　　　　// 日付エラーの処理
　　　　}
　　}

　また GregorianCalendar の日付情報を、画面表示用に String に変換するサンプルは次のようになります。

　String　　　　　　　　　 w_date; // 画面表示用の日付文字列
　SimpleDateFormat　w_sdfmt;
　GregorianCalendar　w_gclndr; // 日付データ

　w_sdfmt = new SimpleDateFormat("yyyy年MM月dd日");
　w_date = w_sdfmt.format(w_gclndr.getTime());

　こういった日付に関する処理の説明があると、必ず出てくる練習問題が「カレンダー表示」です。ここでもそれをやりましょう。

　実現する機能はこんなものでいいでしょう。
　・初期表示ではその月のカレンダーを表示する
　・「前月」ボタンを押すと現在表示の前月のカレンダーを表示する（ボタンでなくリンクでも可）
　・「翌月」ボタンを押すと現在表示の翌月のカレンダーを表示する（ボタンでなくリンクでも可）

　例えばこんな風に表示できればいいと思います。

　あるいは前処理と後処理の部分を変えて、月初の余りに前月の最後、月末の余りに翌月の最初を表示してもいいと思います。

　この練習問題を作成するにあたっては次のことを検討しましょう。

　初期表示の判定は今までの課題と同じで、鍵になるパラメータの有無で判定すればよいと思います。

　前月や翌月はあくまでも現在表示中の年月に対してです。ですから現在表示中の年月をパラメータとして受け取る必要があります。
　一つの方法は画面中に type="hidden" を指定した隠しフィールドを設け、ここに表示中の年月を持つ方法です。そして押されたボタンによって表示するのが前月か翌月かを判定します。

　押されたボタンの判定ですが、getParameter()メソッドでパラメータに画面定義でボタンに付けた名前を指定します（ getParameter("ボタン名") ）。そうすると押されていないボタンの場合はパラメータ自体が存在しないため戻り値がnullになります。これでnull以外のボタン名を判定します。

　もう一つはリンクを使い、飛び先のURLにパラメータとして表示する年月を持たせてしまうものです。この方法の場合は form method= には get しか使えません。

　サンプルはこれとこれです。それぞれでカレンダーの表示形式と、パラメータの処理方法を分けてあります。なお後の方のサンプルでは年間通算日も表示するようにしています。

　特に事務系業務システムで必要な、誤差の無い小数点演算をするための仕組みであるJavaの10進演算について説明します。
　厳密には誤差が無いということはないのですが、小数点を使った際の2進変換誤差が生じないということです。例えば0.2など2進数にすると無限小数になってしまい、厳密に表すことができません（この辺は情報処理試験等でおなじみですね）。こういった倍精度浮動小数点を使おうが厳密に表現できない数値を使って計算を行った場合、人間が手で計算するのと異なる誤差が出ることがあります。このような説明できない誤差が許されない計算をJavaでするときに、この10進演算の仕組みを使うわけです。

　さてJavaで表現できる精度ですが、ほとんど無限に近いんじゃないでしょうか（試してません）。Javaで10進演算を行うときは BigDecimal クラスの参照データ型として定義します。これを使うときに小数点以下の桁数（JavaAPI仕様ではスケールという言葉を使っていますが、ここでは精度を使います）を指定しますが、この桁数指定は int 型の数値で行います。ですからその気になれば int 型で表現できる範囲の小数点以下桁数が指定可能だと思います（これも試してません）。

　また BigDecimal は参照データ型ですが、文字列の String 型と同様に変更不可です。文字列に対して変更を加えると元の文字列を変更するのでなく、変更後の新しい文字列が生成されました。 BigDecimal 型もこれと同じです。
　つまりある BigDecimal 型変数を別の BigDecimal 型変数に代入し、元の変数に変更を加えても、同じ実体を参照しているので両方の変数が同じ値になってしまう、ということはありません。変更を加えたほうは新しい BigDecimal が生成され、そこへの参照に変わります。

　まず10進演算を行うには BigDecimal を使いますが、これを使う場合は java.math.BigDecimal をインポートしてください。
　変数を定義する場合は
　BigDecimal　変数名;
となります。
　例えばCOBOLであればデータの定義のときに精度も決まりますが、 BigDecimal の場合は実際にデータ値を持ったインスタンスを生成するときに精度を指定します。

　まず new 演算子でインスタンス化するときのコンストラクタについて主なものを説明します。

　このコンストラクタで文字列から BigDecimal を生成する場合、文字列の先頭や最後に空白があってもいけません。必ず trim メソッドで空白を削ってください。

int        w_int;
BigDecimal w_num;
w_int = Integer.MAX_VALUE;
w_num = BigDecimal.valueOf(w_int).add(BigDecimal.valueOf(1));
w_int = w_num.intValue();

　Javaの10進演算用の丸め方式は細かく分かれており、全部で8種類あるのですが、ここでは日常よく使うと思うものだけをあげておきます。これ以外についてはAPIドキュメントを参照してください。

　数値情報を BigDecimal 型に変換する方法について、ありがちないくつかのパターンについて具体的に例示します。例として挙げたものは、汎用機でCOBOLで組まれた基幹系システムが動いていて、連動ファイル経由で受けたデータの変換方法に重きを置いています。それから例中で数値を表す文字列中の'_'は、アンダーバーという文字ではなく1桁の空白と捉えてください。

　以下の例全体に対し、次のようにデータ定義がされているものとして話を進めます。

　String      w_src_dat = null;  // 文字列表記の数値データ
　int         w_src_num = 0;  // 2進整数の数値データ
　int         w_scl = 0;      // 数値データの精度（小数点以下桁数）
　BigDecimal w_num = null;      // 変換後の BigDecimal 数値データ

　精度の情報もすでにあり、厳密な書き方で変換すると
　w_num　=　BigDecimal.valueOf((long)w_src_num,　w_scl);
となります。実際には
　w_num　=　BigDecimal.valueOf(w_src_num,　w_scl);
と書いても自動的に型変換されているので大丈夫でした。

　精度についてはあとから適用するなら
　w_num　=　BigDecimal.valueOf((long)w_src_num);
　w_num　=　w_num.movePointLeft(w_src_scl);
となります。

　 BigDecimal は参照データ型なので最初はインスタンス化する必要があります。w_numがすでにインスタンス化されていて、これを再利用するのなら最初の変換の部分は
　w_num　=　w_num.valueOf(w_src_num,　w_scl);
と書けます。

　文字列中に小数点まで含めた数値表現が入っている場合は、次のようにインスタンス化します。必ず trim メソッドで前後の空白を除いてください。
　w_num　=　new　BigDecimal(w_src_dat.trim());

　例えばデータを作成する基幹側のCOBOLで
　05　W-SRC-DAT　　PIC　-(12).999.
や
　05　W-SRC-DAT　　PIC　-9(11).999.
と定義されているとき、こうなります。こうするとCOBOL側からの出力時、先頭の0は空白になり、小数点直前は値が負なら'-'、正なら空白になります。
　例えば上の定義だと-12.345なら"_________-12.345"、0.123なら"____________.123"と編集されます（'_'は空白の意味です）。
　下の定義だと-12.345なら"-00000000012.345"、0.123なら" 00000000000.123" と編集されます。
　編集文字に'-'ではなく'+'を使って
　05　W-SRC-DAT　　PIC　+9(11).999.
とすれば0.123でも"+00000000000.123"となり、先頭の空白は含まれないようになるため trim は無くてもいいんですが、やはり必ず入れる癖を付けたほうがいいでしょう。

　このように数値データ中に小数点を含むのではなく、COBOL側で仮想小数点を使っている場合、今と同じ例なら
　05　W-SRC-DAT　　PIC　-(12)V999.
や
　05　W-SRC-DAT　　PIC　-9(11)V999.
となっている場合は変換方法が変わります。この'V'というのは計算する場合はそこに小数点があるものとして扱うが、データ中には実際の小数点は含まれない、ということを意味します。
　この場合は精度については連動元と連動先の間で事前に取り決めておく必要があります。
　下の定義で12345を表現すると" 00000012345000"、-12.345だと"-00000000012345"と編集されます。

　このときの変換方法は
　w_num　=　new　BigDecimal(w_src_dat.trim());
　w_num　=　w_num.movePointLeft(3);
か
　w_num　=　BigDecimal.valueOf(Integer.parseInt(w_src_dat);
　w_num　=　w_num.movePointLeft(3);
あるいは
　w_num　=　BigDecimal.valueOf(Integer.parseInt(w_src_dat,　3);
としてください（もちろん取り決めに従いw_sclに精度を設定しておき、命令中に'3'という定数を書かないようにしても同じです）。