JavaのLocalDateクラスのgetYearメソッドを完全ガイド!初心者でもわかる年の取得方法
生徒
「Javaで日付から“年”だけを取り出すことってできますか?」
先生
「もちろんできるよ。LocalDateクラスのgetYearメソッドを使えば、年を簡単に取り出すことができるんだ。」
生徒
「なるほど!じゃあ具体的な使い方を教えてください!」
先生
「それじゃあ、JavaのgetYearメソッドの使い方を順番に見ていこう!」
1. java.timeパッケージとは?
「1. java.timeパッケージとは?」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
Javaのjava.timeパッケージは、Java 8以降で導入された新しい日付と時刻のAPI群です。これまでのjava.util.DateやCalendarよりもシンプルかつ明確なコードが書けるようになり、多くの現場で使われています。
このパッケージの中には、日付を扱うLocalDateや、時刻を扱うLocalTime、日付と時刻を合わせて扱うLocalDateTimeなどが用意されています。
2. LocalDateクラスの基本とは?
LocalDateクラスは、年・月・日を扱うクラスで、タイムゾーンや時刻は含まれません。純粋に「カレンダー上の日付」だけを表現するクラスとしてよく使われています。
たとえば、今日の日付を取得したいときには、次のように書きます。
import java.time.LocalDate;
public class TodayExample {
public static void main(String[] args) {
LocalDate today = LocalDate.now();
System.out.println("今日の日付: " + today);
}
}
今日の日付: 2025-09-04
3. getYearメソッドとは?
getYearメソッドは、LocalDateから年の情報をint型で取得するためのメソッドです。たとえば2025年の日付なら、「2025」という数値が取得できます。
構文はとてもシンプルです。以下にサンプルコードを示します。
import java.time.LocalDate;
public class GetYearExample {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2025, 9, 4);
int year = date.getYear();
System.out.println("年: " + year);
}
}
年: 2025
4. getYearで何ができる?
「4. getYearで何ができる?」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
getYearを使えば、例えば「この日付は何年か?」を確認したり、年単位での処理を行うロジックに組み込んだりすることができます。
たとえば、年ごとのレポート出力や、何年に発行されたデータかを確認するログ機能などに活用できます。
また、年を使った条件分岐も簡単に書けます。
LocalDate date = LocalDate.of(2024, 1, 1);
int year = date.getYear();
if (year < 2000) {
System.out.println("2000年より前の日付です。");
} else if (year == 2024) {
System.out.println("今年の日付です。");
} else {
System.out.println("将来の日付かもしれません。");
}
今年の日付です。
5. LocalDateとgetYearを組み合わせた活用例
getYearは、他の日時情報と組み合わせて処理する場面にもよく使われます。たとえば、ユーザーの生年月日から年齢を計算するような場面でも活躍します。
import java.time.LocalDate;
public class AgeCalculator {
public static void main(String[] args) {
LocalDate birthday = LocalDate.of(1990, 5, 10);
int birthYear = birthday.getYear();
int currentYear = LocalDate.now().getYear();
int age = currentYear - birthYear;
System.out.println("年齢: " + age + "歳");
}
}
年齢: 35歳
このように、getYearを活用することで、さまざまな年単位の処理が可能になります。
6. getYearとChronoFieldの違い
Javaでは、年を取得する方法としてgetYearの他に、getLong(ChronoField.YEAR)という方法もあります。
ただし、初心者にはgetYearの方が読みやすく、ミスが少ないためおすすめです。以下は両者を比較した例です。
import java.time.LocalDate;
import java.time.temporal.ChronoField;
public class CompareExample {
public static void main(String[] args) {
LocalDate date = LocalDate.of(2025, 9, 4);
int year1 = date.getYear();
long year2 = date.getLong(ChronoField.YEAR);
System.out.println("getYear: " + year1);
System.out.println("getLong(ChronoField.YEAR): " + year2);
}
}
getYear: 2025
getLong(ChronoField.YEAR): 2025
動作は同じですが、コードの見た目や直感性を考えるとgetYearの方が使いやすいと言えるでしょう。
7. getYearで扱える年の範囲
「7. getYearで扱える年の範囲」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
getYearで扱える年の範囲は非常に広く、LocalDateがサポートしている日付の範囲であれば問題なく取得可能です。
極端な例として、1000年や9999年といった西暦でも問題なく年を取得できます。
LocalDate oldDate = LocalDate.of(1000, 1, 1);
LocalDate futureDate = LocalDate.of(9999, 12, 31);
System.out.println("昔の年: " + oldDate.getYear());
System.out.println("未来の年: " + futureDate.getYear());
昔の年: 1000
未来の年: 9999
この柔軟性も、java.timeパッケージの大きな魅力のひとつです。