Open In App

YearMonth minus(TemporalAmount) method in Java with Examples

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

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

Syntax:

public YearMonth minus(TemporalAmount amountToSubtract)

Parameters: This method accepts only one parameter TemporalAmount which represents the amount to subtract from YearMonth object.

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

Exception: This method throws following Exceptions:

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

Below programs illustrate the minus(TemporalAmount amountToSubtract) method:

Program 1:




// Java program to demonstrate
// YearMonth.minus(TemporalAmount amountToSubtract) 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, 11);
  
        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);
  
        // create temporalAmount object from period class
        // passing temporalAmount to
        // minus() method
        YearMonth value
            = thisYearMonth.minus(
                Period.ofYears(22));
  
        // print result
        System.out.println("Value after Subtraction: "
                           + value);
    }
}


Output:

YearMonth :2019-11
Value after Subtraction: 1997-11

Program 2:




// Java program to demonstrate
// YearMonth.minus(TemporalAmount amountToSubtract) 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(2022, 11);
  
        // print instance
        System.out.println("YearMonth :"
                           + thisYearMonth);
  
        // create temporalAmount object from period class
        // passing temporalAmount to
        // minus() method
        YearMonth value
            = thisYearMonth.minus(
                Period.ofMonths(20));
  
        // print result
        System.out.println("Value after Subtraction: "
                           + value);
    }
}


Output:

YearMonth :2022-11
Value after Subtraction: 2021-03

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



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