Signatur
Beschreibung
Temporal.ZonedDateTime.from() ist die statische Fabrikmethode für Temporal.ZonedDateTime. Ein solches Objekt beschreibt einen genauen Zeitpunkt, der fest an eine IANA-Zeitzone (z. B. "Europe/Berlin") und einen Kalender gebunden ist. Der Konstruktor new Temporal.ZonedDateTime(epochNanoseconds, timeZone) erwartet Nanosekunden als BigInt. from() nimmt dagegen gut lesbare Eingaben an: einen String wie 2024-07-15T09:30:00+02:00[Europe/Berlin] oder ein Objekt mit Feldern wie year, month, day, hour und timeZone.
Verwende die Methode, wenn du eine Uhrzeit in einer bestimmten Zeitzone (Wanduhrzeit) in einen eindeutigen Zeitpunkt umrechnen willst. Typische Fälle sind Termine, Kalendereinträge, Flugzeiten oder gespeicherte Zeitstempel mit Zeitzone. Die Sommerzeit wird automatisch berücksichtigt.
Mit den Optionen legst du fest, was passiert, wenn es eine Uhrzeit nicht gibt (Zeitumstellung vorwärts) oder wenn sie doppelt vorkommt (Zeitumstellung zurück), Option disambiguation. Außerdem regeln sie, wie ein Offset im String behandelt wird, der nicht zur Zeitzone passt (offset), und wie Feldwerte außerhalb des gültigen Bereichs behandelt werden (overflow).
Übergibst du ein bestehendes Temporal.ZonedDateTime, bekommst du eine unabhängige Kopie mit demselben Zeitpunkt, derselben Zeitzone und demselben Kalender. Da Temporal-Objekte unveränderlich sind, brauchst du das selten. Nützlich ist es vor allem, um Eingaben unbekannten Typs einheitlich umzuwandeln.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $info Pflicht | Temporal.ZonedDateTime | Object | string | Die Quelle. Entweder ein Temporal.ZonedDateTime (wird kopiert), ein Objekt mit den Feldern timeZone (Pflicht), year (oder era + eraYear), month (oder monthCode), day und optional hour, minute, second, millisecond, microsecond, nanosecond, offset und calendar, oder ein RFC-9557-String, der zwingend eine Zeitzonen-Annotation in eckigen Klammern enthält, z. B. [Europe/Berlin]. |
|
| $options | Object | {} | Optionales Objekt mit den folgenden Eigenschaften:
|
Rückgabewert
Temporal.ZonedDateTime-Objekt. Es wirft einen TypeError bei ungültigem Eingabetyp oder fehlender timeZone und einen RangeError bei ungültigen Werten, unbekannter Zeitzone, fehlender Zeitzonen-Annotation im String oder wenn eine Option auf "reject" steht und der jeweilige Fall eintritt.