The subtract() method of Temporal.Duration instances returns a new Temporal.Duration object with the difference between this duration and a given duration. It is equivalent to adding the negated value of the other duration.
Syntax
subtract(other)
Parameters
other- : A string, an object, or a Temporal.Duration instance representing a duration to add to this duration. It is converted to a
Temporal.Durationobject using the same algorithm as Temporal/Duration/from.
- : A string, an object, or a Temporal.Duration instance representing a duration to add to this duration. It is converted to a
Return value
A new Temporal.Duration object representing the difference of this duration and other.
Exceptions
- RangeError
- : Thrown in one of the following cases:
- Either
thisorotheris a calendar duration (it has a non-zeroyears,months, orweeks), because calendar durations are ambiguous without a calendar and time reference. - The difference of
thisandotheroverflows the maximum or underflows the minimum representable duration, which is ±2<sup>53</sup> seconds.
- Either
- : Thrown in one of the following cases:
Examples
Using subtract()
const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -20 });
const d3 = d1.subtract(d2);
console.log(d3.toString()); // "PT2H50M"
For more examples and caveats, see the add() method.
Specifications
Browser compatibility
See also
- Temporal.Duration
- Temporal/Duration/add
- Temporal/Duration/negated
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
