java.time.Year Class in Java

java.time.Year represents a year in the ISO-8601 calendar system, such as 2021. It is an immutable date-time class that stores only the year, without a month, day, time, or time zone.

• Year supports proleptic year numbering, in which year 0 exists between years -1 and 1.
• It provides methods to create, retrieve, compare, modify, and format year values.
• It also provides methods to check whether a year is a leap year and to combine a year with a month or day to create date-related objects.

Example: The program creates a Year object for 2024 and checks whether it is a leap year.

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year = Year.of(2024);

        System.out.println("Year: " + year);
        System.out.println("Leap year: " + year.isLeap());
        System.out.println("Number of days: " + year.length());
    }
}

Year: 2024
Leap year: true
Number of days: 366

Explanation: Year.of() creates the year, while isLeap() and length() provide information about it.

Syntax

public final class Year extends Object
implements Temporal, TemporalAdjuster,
Comparable<Year>, Serializable

Working with Year Methods

1. Using atDay()

The atDay() method combines a year with a specified day-of-year and returns a LocalDate.

Syntax

public LocalDate atDay(int dayOfYear)

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year = Year.of(2024);

        System.out.println(year.atDay(60));
    }
}

2024-02-29

Explanation: Day 60 of the leap year 2024 is February 29.

2. Using isAfter()

The isAfter() method checks whether one Year occurs after another Year.

Syntax

public boolean isAfter(Year otherYear)

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year1 = Year.of(2025);
        Year year2 = Year.of(2020);

        System.out.println(year1.isAfter(year2));
    }
}

true

Explanation: The year 2025 occurs after the year 2020, so the method returns true.

3. Using isBefore()

The isBefore() method checks whether one Year occurs before another Year.

Syntax

public boolean isBefore(Year otherYear)

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year1 = Year.of(2020);
        Year year2 = Year.of(2025);

        System.out.println(year1.isBefore(year2));
    }
}

true

Explanation: The year 2020 occurs before the year 2025, so the method returns true.

4. Using isLeap()

The isLeap() method checks whether the year is a leap year.

Syntax

public boolean isLeap()

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year = Year.of(2024);

        System.out.println(year.isLeap());
    }
}

true

Explanation: 2024 is divisible by 4 and is not a century year, so it is a leap year.

5. Using now()

The now() method obtains the current year from the system clock.

Syntax

public static Year now()

import java.time.Year;

public class GFG {
    public static void main(String[] args) {
        Year year = Year.now();

        System.out.println("Current year: " + year);
    }
}

Current year: 2026

Explanation: Year.now() obtains the current year from the system clock.

Note: The output depends on the year in which the program is executed.

Commonly Used Methods