Javaで特定の年・月の日数を取得する方法！GregorianCalendarのgetActualMaximum()メソッド解説

GregorianCalendarクラスとは

GregorianCalendarは、Calendarクラスの具象サブクラスであり、世界で最も広く使用されている標準的な暦体系（グレゴリオ暦）を提供します。Javaでは、このGregorianCalendarを使うことで、グレゴリオ暦だけでなくユリウス暦も扱うことができます。

特定の年におけるある月の日数を調べたい場合は、GregorianCalendarクラスが提供するgetActualMaximum()メソッドを利用します。このメソッドは、指定されたカレンダーフィールドが取り得る最大値を返します。引数には、Calendarクラスの任意のフィールドを指定することが可能です。

getActualMaximum()メソッドの構文

public int getActualMaximum(int field)

サンプルコード

以下の例では、2000年から2017年までの各年について「2月」の日数を取得し、コンソールに出力しています。
2月は閏年かどうかによって日数が変わるため、この処理は閏年の判定にもそのまま応用できます。

import java.util.*;

public class NoOfDaysInAMonthOfAYearTest {
    public static void main(String[] args) {
        for (int i = 2000; i < 2018; i++) {
            Calendar calendar = new GregorianCalendar(i, Calendar.FEBRUARY, 1);
            int numberOfDays = calendar.getActualMaximum(Calendar.DAY_OF_MONTH);
            System.out.println("February " + i + ": " + numberOfDays + " days");
        }
    }
}

実行結果

February 2000: 29 days
February 2001: 28 days
February 2002: 28 days
February 2003: 28 days
February 2004: 29 days
February 2005: 28 days
February 2006: 28 days
February 2007: 28 days
February 2008: 29 days
February 2009: 28 days
February 2010: 28 days
February 2011: 28 days
February 2012: 29 days
February 2013: 28 days
February 2014: 28 days
February 2015: 28 days
February 2016: 29 days
February 2017: 28 days

コードのポイント解説

new GregorianCalendar(i, Calendar.FEBRUARY, 1) のように、対象となる年と月（ここでは2月）、日を1日に指定してインスタンスを生成します。

続いて、calendar.getActualMaximum(Calendar.DAY_OF_MONTH) を呼び出すことで、その年・月に実際に存在する最大の日数（つまりその月の最終日）をint型で取得できます。

実行結果を見ると、2000年・2004年・2008年・2012年・2016年のように4年ごとに「29 days」と表示されていることがわかります。これらは閏年に該当する年です。なお、2000年は「100で割り切れるが400でも割り切れる年」であるため、例外として閏年になる点にも注目してください。このようにgetActualMaximum()を使えば、複雑な閏年の計算ルールを意識することなく、正確に月の日数を取得できます。