ITemporal.Minus Method

Definition

Overloads

Minus(ITemporalAmount)

Returns an object of the same type as this object with an amount subtracted.

Minus(Int64, ITemporalUnit)

Returns an object of the same type as this object with the specified period subtracted.

Minus(ITemporalAmount)

Returns an object of the same type as this object with an amount subtracted.

[Android.Runtime.Register("minus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/temporal/Temporal;", "GetMinus_Ljava_time_temporal_TemporalAmount_Handler:Java.Time.Temporal.ITemporal, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public virtual Java.Time.Temporal.ITemporal? Minus (Java.Time.Temporal.ITemporalAmount? amount);
[<Android.Runtime.Register("minus", "(Ljava/time/temporal/TemporalAmount;)Ljava/time/temporal/Temporal;", "GetMinus_Ljava_time_temporal_TemporalAmount_Handler:Java.Time.Temporal.ITemporal, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Minus : Java.Time.Temporal.ITemporalAmount -> Java.Time.Temporal.ITemporal
override this.Minus : Java.Time.Temporal.ITemporalAmount -> Java.Time.Temporal.ITemporal

Parameters

amount
ITemporalAmount

the amount to subtract, not null

Returns

an object of the same type with the specified adjustment made, not null

Attributes

Remarks

Returns an object of the same type as this object with an amount subtracted.

This adjusts this temporal, subtracting according to the rules of the specified amount. The amount is typically a java.time.Period but may be any other type implementing the TemporalAmount interface, such as java.time.Duration.

Some example code indicating how and why this method is used:

date = date.minus(period);               // subtract a Period instance
             date = date.minus(duration);             // subtract a Duration instance
             date = date.minus(workingDays(6));       // example user-written workingDays method

Note that calling plus followed by minus is not guaranteed to return the same date-time.

Java documentation for java.time.temporal.Temporal.minus(java.time.temporal.TemporalAmount).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

Minus(Int64, ITemporalUnit)

Returns an object of the same type as this object with the specified period subtracted.

[Android.Runtime.Register("minus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/temporal/Temporal;", "GetMinus_JLjava_time_temporal_TemporalUnit_Handler:Java.Time.Temporal.ITemporal, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public virtual Java.Time.Temporal.ITemporal? Minus (long amountToSubtract, Java.Time.Temporal.ITemporalUnit? unit);
[<Android.Runtime.Register("minus", "(JLjava/time/temporal/TemporalUnit;)Ljava/time/temporal/Temporal;", "GetMinus_JLjava_time_temporal_TemporalUnit_Handler:Java.Time.Temporal.ITemporal, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Minus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal
override this.Minus : int64 * Java.Time.Temporal.ITemporalUnit -> Java.Time.Temporal.ITemporal

Parameters

amountToSubtract
Int64

the amount of the specified unit to subtract, may be negative

unit
ITemporalUnit

the unit of the amount to subtract, not null

Returns

an object of the same type with the specified period subtracted, not null

Attributes

Remarks

Returns an object of the same type as this object with the specified period subtracted.

This method returns a new object based on this one with the specified period subtracted. For example, on a LocalDate, this could be used to subtract a number of years, months or days. The returned object will have the same observable type as this object.

In some cases, changing a field is not fully defined. For example, if the target object is a date representing the 31st March, then subtracting one month would be unclear. In cases like this, the field is responsible for resolving the result. Typically it will choose the previous valid date, which would be the last valid day of February in this example.

Java documentation for java.time.temporal.Temporal.minus(long, java.time.temporal.TemporalUnit).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to