Temporal.Duration.from()

Syntax

Temporal.Duration.from(info)

Parameter

info

Eines der folgenden:

• Eine Temporal.Duration-Instanz, die eine Kopie der Instanz erstellt.

• Ein ISO 8601-String, der eine Dauer darstellt.

• Ein Objekt, das mindestens eine der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

  • days
  • hours
  • microseconds
  • milliseconds
  • minutes
  • months
  • nanoseconds
  • seconds
  • weeks
  • years

  Jede Eigenschaft sollte einen ganzzahligen Zahlenwert enthalten. Die resultierende Dauer darf keine gemischten Vorzeichen haben, daher müssen alle diese Eigenschaften das gleiche Vorzeichen (oder null) haben. Fehlende Eigenschaften werden als null behandelt.

Rückgabewert

Ein neues Temporal.Duration-Objekt, möglicherweise unausgeglichen, mit den angegebenen Komponenten.

Ausnahmen

RangeError

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

• Eine der erkannten Eigenschaften im info-Objekt ist keine Ganzzahl (einschließlich nicht endlicher Werte).
• Eine Kalendereinheit (Jahre, Monate, Wochen) hat einen absoluten Wert ≥ 2³².
• Der nicht-kalenderische Teil der Dauer (Tage und darunter), ausgedrückt in Sekunden, hat einen absoluten Wert ≥ 2⁵³.

TypeError

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

• info ist kein Objekt oder String.
• Alle der erkannten Eigenschaften im info-Objekt sind undefined.

Beispiele

Erstellen einer Dauer aus einem Objekt

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
console.log(d1.toString()); // "PT1H30M"

const d2 = Temporal.Duration.from({ months: 1, days: 2 });
console.log(d2.toString()); // "P1M2D"

// Uncommon because unbalanced, but valid
const unbalanced = Temporal.Duration.from({
  hours: 100,
  minutes: 100,
  seconds: 100,
});
console.log(unbalanced.toString()); // "PT100H100M100S"

const neg = Temporal.Duration.from({ hours: -1, minutes: -30 });
console.log(neg.toString()); // "-PT1H30M"

Erstellen einer Dauer aus einem String

const d = Temporal.Duration.from("P1Y2M3W4DT5H6M7.00800901S");
console.log(d.hours); // 5

Erstellen einer Dauer aus einer anderen Dauer

const d1 = Temporal.Duration.from({ hours: 1, minutes: 30 });
const d2 = Temporal.Duration.from(d1);
console.log(d2.toString()); // "PT1H30M"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal.Duration
• Temporal.Duration()
• Temporal.Duration.prototype.with()