Temporal.PlainTime.prototype.add()

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die add() Methode von Instanzen von Temporal.PlainTime gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit verschoben um eine gegebene Dauer darstellt (in einer Form, die durch Temporal.Duration.from() konvertierbar ist), wobei wenn nötig der Tag umschlagen wird.

Syntax

add(duration)

Parameter

duration: Ein String, ein Objekt oder eine Instanz von Temporal.Duration, die eine hinzuzufügende Dauer zu dieser Zeit darstellt. Diese wird unter Verwendung desselben Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration-Objekt umgewandelt.

Rückgabewert

Ein neues Temporal.PlainTime-Objekt, das die durch das ursprüngliche PlainTime angegebene Zeit plus der Dauer darstellt. Alle Einheiten über hours hinaus werden ignoriert, und wenn die Zeit über Mitternacht hinausgeht, wird sie auf den nächsten Tag umgeschlagen.

Eine Dauer hinzuzufügen ist gleichbedeutend mit dem Subtrahieren der Negation derselben.

Beispiele

Eine Dauer hinzufügen

const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 1, minutes: 30 });
console.log(end.toString()); // 14:04:56

const end2 = start.add({ hours: -1, minutes: -30 });
console.log(end2.toString()); // 11:04:56

const distance = Temporal.PlainTime.from("00:00:00").until("01:23:45"); // 1h 23m 45s
const end3 = start.add(distance);
console.log(end3.toString()); // 13:58:41

Zeitüberschlag

Wenn die Zeit über Mitternacht hinausgeht, wird sie auf den nächsten Tag umgeschlagen:

const start = Temporal.PlainTime.from("12:34:56");
const end = start.add({ hours: 12 });
console.log(end.toString()); // 00:34:56

Spezifikationen

Specification
Temporal # sec-temporal.plaintime.prototype.add