Temporal.ZonedDateTime.prototype.since()

other

Ein String, ein Objekt oder eine Temporal.ZonedDateTime-Instanz, die einen Datum-Zeit-Wert darstellt und von diesem Datum-Zeit-Wert subtrahiert wird. Es wird mit dem gleichen Algorithmus wie Temporal.ZonedDateTime.from() in ein Temporal.ZonedDateTime-Objekt konvertiert. Es muss denselben Kalender wie this haben.

options Optional

Ein Objekt, das die Optionen für Temporal.Duration.prototype.round() enthält, darunter largestUnit, roundingIncrement, roundingMode und smallestUnit. largestUnit und smallestUnit akzeptieren alle möglichen Einheiten. Für largestUnit bedeutet der Standardwert "auto" "hours" oder smallestUnit, je nachdem, welcher größer ist. Für smallestUnit ist der Standardwert "nanoseconds". Das aktuelle Datum wird als relativeTo-Option verwendet. Beachten Sie, dass die Verwendung von Einheiten größer als "hours" die Dauer möglicherweise nicht portierbar zu anderen Kalendern, Daten oder Zeitzonen macht.

Ein neues Temporal.Duration-Objekt, das die Dauer seit other bis zu diesem Datum-Zeit-Wert darstellt. Die Dauer ist positiv, wenn other vor diesem Datum-Zeit-Wert liegt, und negativ, wenn er danach liegt.

RangeError

Wird in einem der folgenden Fälle ausgelöst:

• other hat einen anderen Kalender als this.
• Eine der Optionen ist ungültig.
• other hat eine andere Zeitzone als this, und largestUnit ist "days" oder höher.

Die zurückgegebene Dauer ist eine "hybride" Dauer. Das bedeutet, dass der Datumsanteil der Dauer volle Kalendertage repräsentiert, wie es Temporal.PlainDateTime.prototype.since() zurückgeben würde, während der Zeitanteil die tatsächlich verstrichene Zeit darstellt, wie es Temporal.Instant.prototype.since() zurückgeben würde. Dieser Ansatz der "hybriden Dauer" passt sich automatisch an Sommerzeitumstellungen an und entspricht weit verbreiteten Industriestandards wie RFC 5545 (iCalendar). Siehe unten für Beispiele.

Wenn Übergänge stattfinden, kann ein Tag nicht genau 24 Stunden haben.

const start = Temporal.ZonedDateTime.from(
  "2024-11-03T01:00:00-04:00[America/New_York]",
);
const end = Temporal.ZonedDateTime.from(
  "2024-11-04T01:00:00-05:00[America/New_York]",
);
console.log(end.since(start).toString()); // PT25H
console.log(end.since(start, { largestUnit: "days" }).toString()); // PT1D

const start2 = Temporal.ZonedDateTime.from(
  "2024-03-10T01:00:00-05:00[America/New_York]",
);
const end2 = Temporal.ZonedDateTime.from(
  "2024-03-11T01:00:00-04:00[America/New_York]",
);
console.log(end2.since(start2).toString()); // PT23H
console.log(end2.since(start2, { largestUnit: "days" }).toString()); // PT1D

Aus diesem Grund ist die zurückgegebene Dauer standardmäßig rein zeitbasiert und enthält keinen Datumsanteil, um eindeutig zu bleiben.

Der Zeitanteil der zurückgegebenen Dauer basiert ausschließlich auf Instanzen und wird nicht von Zeitzonen beeinflusst. Wenn Sie jedoch Datumsbestandteile wie day einbeziehen möchten, müssen der Start und das Ende in der gleichen Zeitzone liegen.

const start = Temporal.ZonedDateTime.from(
  "2024-11-03T01:00:00-04:00[America/New_York]",
);
// Peru does not use DST so its offset remains -05:00 year-round
const end = Temporal.ZonedDateTime.from(
  "2024-11-04T01:00:00-05:00[America/Lima]",
);

end.since(start); // PT25H
end.since(start, { largestUnit: "days" }); // RangeError: time zones "America/Lima" and "America/New_York" aren't compatible

end.withTimeZone("America/New_York").since(start, { largestUnit: "days" }); // P1D
end.since(start.withTimeZone("America/Lima"), { largestUnit: "days" }); // P1D1H

Weitere Beispiele zur Verwendung von since(), insbesondere mit Rundung, finden Sie unter Temporal.PlainDate.prototype.since() und Temporal.PlainTime.prototype.since().

• Temporal.ZonedDateTime
• Temporal.Duration
• Temporal.ZonedDateTime.prototype.add()
• Temporal.ZonedDateTime.prototype.subtract()
• Temporal.ZonedDateTime.prototype.until()