Temporal.Duration.prototype.negated()

Baseline Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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()

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 # sec-temporal.duration.prototype.negated

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`negated`	144	144	139	128	preview	144	139	95	No	No	144	No	1.4.0	2.7	26.0.0