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
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
negated |
Legend
Tip: you can click/tap on a cell for more information.
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.