Temporal.Duration.prototype.negated()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The negated() method of Temporal.Duration instances returns a new Temporal.Duration object with the negated value of this duration (all fields keep the same magnitude, but sign becomes reversed).
Syntax
js
negated()
Parameters
None.
Return value
A new Temporal.Duration object, where all fields have the same magnitude as this duration, but the sign is reversed (positive fields become negative, and vice versa).
Examples
Using negated()
js
const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from({ hours: -1, minutes: -30 });
console.log(d1.negated().toString()); // "-PT1H30M"
console.log(d2.negated().toString()); // "PT1H30M"
Specifications
| Specification |
|---|
| Temporal proposal # sec-temporal.duration.prototype.negated |
Browser compatibility
BCD tables only load in the browser