ITemporal.Minus Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.