Saturday, October 25, 2025
HomeLanguagesJavaYear minus(long,unit) method in Java with Examples

Year minus(long,unit) method in Java with Examples

The minus(long, unit) method of Year class is used to return a copy of this year after subtracting the specified amount of unit from this Year object.An exception is thrown, If the specified unit cannot be subtracted from Year. This instance is immutable and unaffected by this method call.

Syntax:

public Year minus(long amountToSubtract, TemporalUnit unit)

Parameters: This method accepts two parameters:

  • amountToSubtract: This parameter represents the amount of the unit to subtract from the result.
  • unit: This parameter represents the unit of the amount to subtract.

Return Value: This method returns a Year based on this year with the specified amount subtracted.

Exception: This method throws following Exceptions:

  • DateTimeException – This exception is thrown if the subtraction cannot be made.
  • UnsupportedTemporalTypeException – This exception is thrown if the unit is not supported.
  • ArithmeticException – This exception is thrown if numeric overflow occurs.

Below programs illustrate the minus(long, unit) method:

Program 1:




// Java program to demonstrate
// Year.minus(long, unit) method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // create a Year object
        Year year = Year.of(2019);
  
        // print instance
        System.out.println("Year :"
                           + year);
  
        // apply minus(long, unit) method
        // subtracting 20 years
        Year value
            = year.minus(20, ChronoUnit.YEARS);
  
        // print result
        System.out.println("After subtraction year: "
                           + value);
    }
}


Output:

Year :2019
After subtraction year: 1999

Program 2:




// Java program to demonstrate
// Year.minus(long, unit) method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // create a Year object
        Year year = Year.of(2022);
  
        // print instance
        System.out.println("Year :"
                           + year);
  
        // apply minus(long, unit) method
        // subtracting 30 years
        Year value
            = year.minus(30, ChronoUnit.YEARS);
  
        // print result
        System.out.println("After subtraction year: "
                           + value);
    }
}


Output:

Year :2022
After subtraction year: 1992

References:
https://docs.oracle.com/javase/10/docs/api/java/time/Year.html#minus(long, java.time.temporal.TemporalUnit)

RELATED ARTICLES

Most Popular

Dominic
32361 POSTS0 COMMENTS
Milvus
88 POSTS0 COMMENTS
Nango Kala
6728 POSTS0 COMMENTS
Nicole Veronica
11892 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11954 POSTS0 COMMENTS
Shaida Kate Naidoo
6852 POSTS0 COMMENTS
Ted Musemwa
7113 POSTS0 COMMENTS
Thapelo Manthata
6805 POSTS0 COMMENTS
Umr Jansen
6801 POSTS0 COMMENTS