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); } } |
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); } } |
YearMonth :2022-11 Value after Subtraction: 2021-03