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

2018年9月17日 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);

サンプルプログラム

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

実行

　サンプルプログラムでは、リターン値として計算後の日付を保持する 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 の「カレンダー・スケジュール管理機能」で実際に利用しています。

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

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

サンプルプログラム

実行

Java 数値⇔文字列⇔日付の変換

Javaの基本的な配列操作まとめ

Java 変数の型を instanceof で確認する

Javaの基本的な文字列操作まとめ

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

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