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 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.Instant-Instanz, die eine Kopie der Instanz erstellt.
  • Ein RFC 9557-String, der ein Datum, eine Uhrzeit und einen Zeitzonen-Offset enthält. Der Name der Zeitzone wird ignoriert; nur der Offset wird verwendet.

Rückgabewert

Ein neues Temporal.Instant-Objekt, das den durch info angegebenen Moment in der Zeit darstellt.

Ausnahmen

TypeError

Wird ausgelöst, wenn info weder eine Temporal.Instant-Instanz noch 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 vom Unix-Epoch umfasst.

Beispiele

Ein Instant aus einem String erstellen

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(instant.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(instant.toString()); // 1969-12-31T16:00:00Z; the time zone name is ignored

Ein Instant aus einem anderen Instant erstellen

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 proposal
# sec-temporal.instant.from

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
from
Experimental

Legend

Tip: you can click/tap on a cell for more information.

In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch