JavaのLocalDateとgetDayOfYearの使い方を完全ガイド！初心者でもわかる通算日数の取得方法

1. java.timeパッケージとは？

「1. java.timeパッケージとは？」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. java.timeパッケージとは？

Javaのjava.timeパッケージは、日付や時間を扱うために用意されたクラス群で、Java 8から正式に導入されました。従来のjava.util.DateやCalendarに比べて、直感的でミスが起きにくい構文が特徴です。

中でもLocalDateクラスは、年月日を扱うのに特化したクラスで、時刻やタイムゾーンを必要としない処理に最適です。これにより、特定の日付を扱う処理をより安全かつ簡潔に記述できるようになります。

2. LocalDateクラスとは？

2. LocalDateクラスとは？

LocalDateクラスは、java.timeパッケージ内にある日付専用のクラスです。このクラスを使うと、「2025年9月4日」のような日付を簡単に表現・操作できます。

たとえば、現在の日付を取得するには次のように書きます。

import java.time.LocalDate;

public class LocalDateNowExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今日の日付: " + today);
    }
}

3. getDayOfYearメソッドとは？

3. getDayOfYearメソッドとは？

getDayOfYearメソッドは、指定した日付がその年の何日目にあたるかを整数（1〜365または366）で返すメソッドです。閏年（うるうどし）の場合は最大366になります。

例えば、2025年9月4日は、1月1日から数えて248日目です。これを取得するコードは以下のようになります。

import java.time.LocalDate;

public class DayOfYearExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        int dayOfYear = today.getDayOfYear();
        System.out.println("今日は今年の " + dayOfYear + " 日目です。");
    }
}

今日は今年の 248 日目です。

4. 特定の日付の通算日数を調べる

「4. 特定の日付の通算日数を調べる」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. 特定の日付の通算日数を調べる

任意の日付が1年の中で何日目かを調べる場合にもgetDayOfYearは便利です。たとえば、「2024年12月31日」がその年の何日目かを取得するには、次のように書きます。

import java.time.LocalDate;

public class SpecificDayOfYear {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 12, 31);
        int day = date.getDayOfYear();
        System.out.println("2024年12月31日は " + day + " 日目です。");
    }
}

2024年12月31日は 366 日目です。

2024年はうるう年なので、最終日は366日目となります。

5. 通算日数から年初からの経過率を算出する

5. 通算日数から年初からの経過率を算出する

通算日数がわかると、1年のうち何パーセントが経過したかを計算することもできます。以下はその実装例です。

import java.time.LocalDate;

public class ProgressOfYear {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        int day = today.getDayOfYear();
        int totalDays = today.isLeapYear() ? 366 : 365;

        double progress = (day / (double) totalDays) * 100;
        System.out.printf("今年は %.2f%% 経過しました。%n", progress);
    }
}

うるう年かどうかも考慮して、isLeapYear()で年の日数を動的に判断しています。

6. getDayOfYearとgetDayOfWeekの違い

6. getDayOfYearとgetDayOfWeekの違い

同じくLocalDateクラスにはgetDayOfWeekというメソッドもありますが、これは曜日（月曜〜日曜）を取得するものです。一方、getDayOfYearは年の中で何日目かを表します。

たとえば、2025年1月1日は「水曜日（WEDNESDAY）」であり、同時に「1日目（1）」でもあります。このように目的に応じて使い分けることが大切です。

7. java.timeとLocalDateの使いどころ

「7. java.timeとLocalDateの使いどころ」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. java.timeとLocalDateの使いどころ

java.timeパッケージのLocalDateは、業務アプリケーションでも非常によく使われます。日付の入力や帳票の発行、カレンダー機能など、実用的な場面が多いためです。

特にgetDayOfYearは、進捗の可視化やイベント管理に役立つ機能であり、プロジェクト管理やタスクスケジューリングにも応用できます。

このようにJavaのjava.timeパッケージは、シンプルでありながら強力な日付処理を提供してくれる便利なAPIです。初心者のうちから使い慣れておくと、実践でとても役立ちます。