Java 日付・時刻の計算　加算・減算が簡単に

Java 日付・時刻の計算　加算・減算が簡単に

　Java で簡単に日付・時刻の加算・減算を計算するサンプルプログラムを紹介します。
サンプルプログラムの特徴は以下となります。

• 現在、または任意の日付・時刻から指定の時間量を加算・減算した結果を返します。
• プラスの数値を指定した場合時間を進め、マイナスの場合は戻します。
  たとえば、現在の日付時刻から 10 日前を計算する場合は以下となります。
  Calendar cal = addMonth(-10);
• 年、月、日、時間、分、秒、ミリ秒の各時間フィールドに対し、任意の時間量を設定できます。
  また、指定の時間から相対的に計算する場合は、引数にCalendarクラスを渡す。
  たとえば、以下では指定のCalendarインスタンスから1年進めることになります。
  Calendar cal = add(“指定のCalendar”,1,0,0,0,0,0,0);
• 各時間フィールドの値がその範囲を超えた場合、次の大きい時間フィールドが増分または減分されます。
  たとえば、以下では現在時刻から1時間と5分進めることになります。
  Calendar cal = addMinute(65);

サンプルプログラム

/**<br /> * 現在の日付・時刻から指定の【年数】を加算・減算した結果を返します。<br /> * @param addYera 加算・減算する年数<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addYera(int addYera){<br /> return add(null,addYera,0,0,0,0,0,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の【月数】を加算・減算した結果を返します。<br /> * @param addMonth 加算・減算する月数<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addMonth(int addMonth){<br /> return add(null,0,addMonth,0,0,0,0,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の【日数】を加算・減算した結果を返します。<br /> * @param addDate 加算・減算する日数<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addDate(int addDate){<br /> return add(null,0,0,addDate,0,0,0,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の【時間】を加算・減算した結果を返します。<br /> * @param addHour 加算・減算する時間<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addHour(int addHour){<br /> return add(null,0,0,0,addHour,0,0,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の【分】を加算・減算した結果を返します。<br /> * @param addMinute 加算・減算する分<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addMinute(int addMinute){<br /> return add(null,0,0,0,0,addMinute,0,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の【秒】を加算・減算した結果を返します。<br /> * @param addSecond 加算・減算する秒<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar addSecond(int addSecond){<br /> return add(null,0,0,0,0,0,addSecond,0);<br /> }<br /> /**<br /> * 現在の日付・時刻から指定の時間量を加算・減算した結果を返します。<br /> * 年、月、日、時間、分、秒、ミリ秒の各時間フィールドに対し、<br /> * 任意の時間量を設定できます。<br /> * たとえば、現在の日付時刻から 10 日前を計算する場合は以下となります。<br /> * Calendar cal = add(null,0,0,-10,0,0,0,0);<br /> *<br /> * 各時間フィールドの値がその範囲を超えた場合、次の大きい時間フィールドが<br /> * 増分または減分されます。<br /> * たとえば、以下では1時間と5分進めることになります。<br /> * Calendar cal = add(null,0,0,0,0,65,0,0);<br /> *<br /> * 各時間フィールドに設定する数量が0の場合は、現在の値が設定されます。<br /> * java.util.GregorianCalendarの内部処理では以下の分岐を行っている。<br /> * if (amount == 0) {<br /> * return;<br /> * }<br /> *<br /> * @param cal 日付時刻の指定があればセットする。<br /> * nullの場合、現在の日付時刻で新しいCalendarインスタンスを生成する。<br /> * @param addYera 加算・減算する年数<br /> * @param addMonth 加算・減算する月数<br /> * @param addDate 加算・減算する日数<br /> * @param addHour 加算・減算する時間<br /> * @param addMinute 加算・減算する分<br /> * @param addSecond 加算・減算する秒<br /> * @param addMillisecond 加算・減算するミリ秒<br /> * @return 計算後の Calendar インスタンス。<br /> */<br /> public static Calendar add(Calendar cal,<br /> int addYera,int addMonth,int addDate,<br /> int addHour,int addMinute,int addSecond,<br /> int addMillisecond){<br /> if (cal == null) {<br /> cal = Calendar.getInstance();<br /> }<br /> cal.add(Calendar.YEAR, addYera);<br /> cal.add(Calendar.MONTH, addMonth);<br /> cal.add(Calendar.DATE, addDate);<br /> cal.add(Calendar.HOUR_OF_DAY, addHour);<br /> cal.add(Calendar.MINUTE, addMinute);<br /> cal.add(Calendar.SECOND, addSecond);<br /> cal.add(Calendar.MILLISECOND, addMillisecond);<br /> return cal;<br /> }<br />

実行

　サンプルプログラムでは、リターン値として計算後の日付を保持する java.util.Calendar オブジェクトを取得できますので、java.util.Calendar#getTime()メソッドにより、java.util.Dateに変換し java.text.SimpleDateFormat により日付文字列に変換しています。

◆実行例

public static void main(String[] args) {

SimpleDateFormat f = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
System.out.println("現在　　　の日付・時刻 = "+ f.format(add(null,0,0,0,0,0,0,0).getTime()));
System.out.println("１年後　　の日付・時刻 = "+ f.format(addYera(1).getTime()));
System.out.println("１ヶ月前　の日付・時刻 = "+ f.format(addMonth(-1).getTime()));
System.out.println("３時間後　の日付・時刻 = "+ f.format(addHour(3).getTime()));
System.out.println("３０時間前の日付・時刻 = "+ f.format(addHour(-30).getTime()));
System.out.println("４０分後　の日付・時刻 = "+ f.format(addMinute(40).getTime()));
System.out.println("８０秒後　の日付・時刻 = "+ f.format(addSecond(80).getTime()));
System.out.println("１ヶ月前から、４日後の日付・時刻 = "+ f.format(add(null,0,-1,4,0,0,0,0).getTime()));

}

◆実行結果
現在の日付時刻は 2008/03/25 00:00:00 とします。

現在　　　の日付・時刻 = 2008/03/25 00:00:00
１年後　　の日付・時刻 = 2009/03/25 00:00:00
１ヶ月前　の日付・時刻 = 2008/02/25 00:00:00
３時間後　の日付・時刻 = 2008/03/25 03:00:00
３０時間前の日付・時刻 = 2008/03/23 18:00:00
４０分後　の日付・時刻 = 2008/03/25 00:40:00
８０秒後　の日付・時刻 = 2008/03/25 00:01:20
１ヶ月前から、４日後の日付・時刻 = 2008/02/29 00:00:00

※2008年は閏年のため2月の月末日付は29日となります。

このサンプルプログラムは Chat&Messenger の「カレンダー・スケジュール管理機能」で実際に利用しています。