JavaのCalendarクラスでのaddメソッドの違い: DAY_OF_YEAR vs DAY_OF_MONTH

JavaのCalendarクラスには、日付を操作するためのaddメソッドがあります。このメソッドを使って、日付を変更する際に「DAY_OF_YEAR」と「DAY_OF_MONTH」を使用する場合、それぞれがどのように異なる動作をするのか、具体的に解説します。

1. Calendarクラスとは？

まず、JavaのCalendarクラスは、日付と時間の計算を簡単に行うために用いられる便利なクラスです。addメソッドを使うことで、指定したフィールド（例: 年、月、日）に対して加算や減算を行えます。

「DAY_OF_YEAR」はその年の何日目かを指定します。つまり、1月1日からの経過日数に基づいて日付が計算されます。一方、「DAY_OF_MONTH」は、その月の何日目かを指定し、月単位で日付が計算されます。

例えば、次の2つのコードについて見てみましょう。

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_YEAR, 100);

この場合、「DAY_OF_YEAR」を100日加算すると、その年の1月1日から100日後の日付が計算されます。

Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DAY_OF_MONTH, 100);

「DAY_OF_MONTH」を100日加算した場合、月をまたぐことになります。例えば、1月1日から100日後の日付は4月10日になります。

日付の加算や変更が年単位で行いたい場合は「DAY_OF_YEAR」を使用し、月単位で日付を変更したい場合は「DAY_OF_MONTH」を使用するのが適切です。どちらを使うかは、操作したい日付の粒度によって選択しましょう。

JavaのCalendarクラスにおける「DAY_OF_YEAR」と「DAY_OF_MONTH」の違いは、日付の加算を年単位で行うか月単位で行うかにあります。用途に応じて適切なフィールドを選んで使用することが大切です。