Temporal.Instant.from()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Die statische Methode Temporal.Instant.from() erstellt ein neues Temporal.Instant Objekt aus einem anderen Temporal.Instant Objekt oder einem RFC 9557 String.
Syntax
js
Temporal.Instant.from(info)
Parameter
info-
Eines der folgenden:
- Eine
Temporal.InstantInstanz, die eine Kopie der Instanz erstellt. - Ein RFC 9557 String, der ein Datum, eine Uhrzeit und einen Zeitzonenoffset enthält. Der Name der Zeitzone wird ignoriert; nur der Offset wird verwendet.
- Eine
Rückgabewert
Ein neues Temporal.Instant Objekt, das den Zeitpunkt in der Zeit repräsentiert, der durch info angegeben ist.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
infokeineTemporal.InstantInstanz oder ein String ist. RangeError-
Wird in einem der folgenden Fälle ausgelöst:
- Der String ist kein gültiger RFC 9557 String.
- Die Info liegt nicht im darstellbaren Bereich, welcher ±108 Tage oder etwa ±273,972.6 Jahre ab der Unix-Epoche umfasst.
Beispiele
Erstellen eines Instants aus einem String
js
const instant = Temporal.Instant.from("1970-01-01T00Z");
console.log(instant.toString()); // 1970-01-01T00:00:00Z
const instant2 = Temporal.Instant.from("1970-01-01T00+08:00");
console.log(instant2.toString()); // 1969-12-31T16:00:00Z
// America/New_York is UTC-5 in January 1970, not UTC+8
const instant3 = Temporal.Instant.from("1970-01-01T00+08:00[America/New_York]");
console.log(instant3.toString()); // 1969-12-31T16:00:00Z; the time zone name is ignored
Erstellen eines Instants aus einem anderen Instant
js
const instant = Temporal.Instant.from("1970-01-01T00Z");
const instant2 = Temporal.Instant.from(instant);
console.log(instant2.toString()); // 1970-01-01T00:00:00Z
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal.instant.from |