Temporal.Instant.from()
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 Temporal.Instant.from() statische Methode 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 Zeitzonen-Offset enthält. Der Zeitzonenname wird ignoriert; nur der Offset wird verwendet.
- Eine
Rückgabewert
Ein neues Temporal.Instant Objekt, das den durch info angegebenen Zeitpunkt darstellt.
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 Information liegt nicht im darstellbaren Bereich, der ±108 Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche umfasst.
Beispiele
Erstellen eines Zeitpunkts 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 Zeitpunkts aus einem anderen Zeitpunkt
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
| Specification |
|---|
| Temporal # sec-temporal.instant.from |