Open In App

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

Improve
Improve
Like Article
Like
Save
Share
Report

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

Syntax:

public YearMonth 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-month based on this Year-month 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
// YearMonth.minus(long, unit) method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // Create a YearMonth object
        YearMonth thisYearMonth = YearMonth.of(2017, 8);
  
        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);
  
        // apply minus(long, unit) method
        // subtracting 20 Years
        YearMonth value
            = thisYearMonth.minus(20, ChronoUnit.YEARS);
  
        // print result
        System.out.println("After subtraction YearMonth: "
                           + value);
    }
}


Output:

YearMonth :2017-08
After subtraction YearMonth: 1997-08

Program 2:




// Java program to demonstrate
// YearMonth.minus(long, unit) method
  
import java.time.*;
import java.time.temporal.*;
  
public class GFG {
    public static void main(String[] args)
    {
        // Create a YearMonth object
        YearMonth thisYearMonth = YearMonth.of(2019, 12);
  
        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);
  
        // apply minus(long, unit) method
        // subtracting 30 Months
        YearMonth value
            = thisYearMonth.minus(30, ChronoUnit.MONTHS);
  
        // print result
        System.out.println("After subtraction YearMonth: "
                           + value);
    }
}


Output:

YearMonth :2019-12
After subtraction YearMonth: 2017-06

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



Last Updated : 30 Jul, 2019
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads