【Java入門】Calendarクラスで日付を操作する方法（getメソッド,setメソッド,addメソッド,rollメソッド)

Calendarクラス

・Calendarクラスとは

　現在の年月日を取得したり、指定した日時の設定や加算・減算、日時を比較するなど、日時を扱うさまざまな処理が可能なクラスです。
　使用するには以下のパッケージを取得する必要があります。

パッケージのインポート

import java.util.Calendar

　
　また生成の方法は、抽象クラスのためnew演算子でオブジェクト生成はできず、getInstance()メソッドを使用して生成します。

Calendarクラスの生成

Calendar cl = Calendar.getInstance();

　getInstanceメソッドは、オブジェクトを生成する度に、現在の年・月・日に初期化された状態でオブジェクトを返します。getInstance()は、クラスメソッドでコンピューターの設定に合わせて適切なカレンダーを取得します。（大体はグレゴリオ暦なのでGregorianCalendarのインスタンスが入ります。）

・get()メソッドで日付を取得する

　ここではget()メソッドを使って日付を取得する方法を説明します。
以下のサンプルコードのようにgetTime()メソッドとget()メソッドを使うことで日付の要素を取得することができます。

日付を取得する二つの方法

import java.util.Calendar;

public class Main {
	public static void main(String[] args) {
		
		// Calendarクラスの生成
		Calendar cl = Calendar.getInstance();
		
		// 現在日時の出力
		System.out.println("現在日時：" + cl.getTime());
        // getメソッドで年・月・日・時間を出力
		System.out.println("年：" + cl.get(Calendar.YEAR));
		System.out.println("月：" + (cl.get(Calendar.MONTH) + 1));
		System.out.println("日：" + cl.get(Calendar.DATE));
		System.out.println("時間：" + cl.get(Calendar.HOUR));

	}
}

実行結果

日付：Sat Sep 30 22:21:56 JST 2023
年：2023
月：9
日：30
時間：10

　getTime()メソッドでは、Dateオブジェクトを返すため、Calendarクラス生成時に初期化された日時が取得できます。get()メソッドでは、指定されたCalendarのフィールドの値を返します。サンプルコードでは、年・月・日・時間をそれぞれ取得しています。フィールドは他にいくつかあります。

※月に関しては、「0」から始まるので0が１月になります。そのため出力する時は、誤認をなくすために＋１をしています。

・フィールド一覧

フィールド	説明
YEAR	年
MONTH	月
DATE	日
HOUR	時間（12時間）
MINUTE	分
SECOND	秒
HOUR_OF_DAY	時間（24時間）
AM_PM	午前なら「０」、午後なら「１」を返す

・set()メソッド日付を設定する

　ここではset()メソッドを使って日付を設定する方法を説明します。
set()メソッドは、第一引数にフィールド、第二引数に設定する値を指定することで、要素を設定することができます。

public void set(int field, int value)

　以下のサンプルコードのようにset()メソッドを使うことで「年」を変更できます。第一引数は、Calendarクラスのフィールドを指定することで設定する要素を選ぶことができます。

set()メソッドで年の設定

import java.util.Calendar;

public class Main {
	public static void main(String[] args) {
		
		// Calendarクラスの生成と現在日時の出力
		Calendar cl = Calendar.getInstance();
		System.out.println("現在日時：" + cl.getTime());
		
		
		// set()メソッドで年を設定
		cl.set(Calendar.YEAR, 2019);
		
		System.out.println("変更後日時：" + cl.getTime());
		
	}
}

実行結果

現在日時：Sun Oct 01 10:07:02 JST 2023
変更後日時：Tue Oct 01 10:07:02 JST 2019

・まとめて日付を設定する【応用】

　上記のようにフィールドを指定して設定する他に、まとめて設定する方法があります。set()メソッドにはオーバーロードされたメソッドが３つあります。

public void set​(int year, int month, int date)

public void set​(int year, int month, int date, int hourOfDay, int minute)

public void set​(int year, int month, int date, int hourOfDay, int minute, int second)

　
　以下のサンプルコードでは、３つのset()メソッドを使って日付を設定してみます。

set()メソッドで年の設定

import java.util.Calendar;

public class Main {
	public static void main(String[] args) {
		
		// Calendarクラスの生成と現在日時の出力
		Calendar cl = Calendar.getInstance();
		System.out.println("現在日時　　　　：" + cl.getTime());
		
		
		// set()メソッドでまとめて要素を設定
		cl.set(2019,1,1);
		System.out.println("年月日変更　　　：" + cl.getTime());
		
		cl.set(2019,1,1,1,1);
		System.out.println("年月日時分変更　：" + cl.getTime());
		
		cl.set(2019,1,1,1,1,1);
		System.out.println("年月日時分秒変更：" + cl.getTime());
		
	}
}

実行結果

現在日時　　　　：Sun Oct 01 10:25:37 JST 2023
年月日変更　　　：Fri Feb 01 10:25:37 JST 2019
年月日時分変更　：Fri Feb 01 01:01:37 JST 2019
年月日時分秒変更：Fri Feb 01 01:01:01 JST 2019

・add()メソッドで日付を加算/減算する

　ここではadd()メソッドを使って日付を設定する方法を説明します。
add()メソッドは、第一引数にフィールド、第二引数に加算または減算を入れて、要素を変更することができます。

public abstract void add​(int field, int amount)

　以下のサンプルコードのようにset()メソッドを使うことで「年」を変更できます。第一引数は、Calendarクラスのフィールドを指定することで設定する要素を選ぶことができます。

set()メソッドで年の設定

import java.util.Calendar;

public class Main {
	public static void main(String[] args) {
		
		// Calendarクラスの生成と現在日の出力
		Calendar cl = Calendar.getInstance();
		System.out.println("現在日時　　　：" + cl.getTime());
		
		
		// add()メソッドで要素を変更
		cl.add(Calendar.YEAR, 1);
		System.out.println("１年追加　　　：" + cl.getTime());
		
		cl.add(Calendar.MONTH, -1);
		System.out.println("１月減算　　　：" + cl.getTime());
		
		
		
	}
}

実行結果

現在日時　　　：Sun Oct 01 10:38:22 JST 2023
１年追加　　　：Tue Oct 01 10:38:22 JST 2024
１月減算　　　：Sun Sep 01 10:38:22 JST 2024