Temporal.ZonedDateTime.from()

info

Eines der folgenden:

• Eine Instanz von Temporal.ZonedDateTime, die eine Kopie der Instanz erstellt.
• Ein RFC 9557-Format-String, der ein Datum enthält, optional eine Uhrzeit, optional ein Offset, eine Zeitzonenanmerkung und optional einen Kalender.
• Ein Objekt, das Eigenschaften enthält, die entweder von Temporal.PlainDate.from() (calendar, era, eraYear, year, month, monthCode, day) oder Temporal.PlainTime.from() (hour, minute, second, millisecond, microsecond, nanosecond) akzeptiert werden. Die Informationen sollten explizit ein Jahr (als year oder als era und eraYear), einen Monat (als month oder monthCode) und einen Tag angeben; andere sind optional und werden auf ihre Standardwerte gesetzt. Die folgenden Eigenschaften sollten ebenfalls bereitgestellt werden:

  timeZone

  Entweder ein String oder eine Instanz von Temporal.ZonedDateTime, die die zu verwendende Zeitzone darstellt. Wenn eine Instanz von Temporal.ZonedDateTime, wird ihre Zeitzone verwendet. Wenn ein String, kann es sich um einen benannten Zeitzonenbezeichner, einen Offset-Zeitzonenbezeichner oder einen Datums- und Uhrzeiten-String mit Zeitzonenbezeichner oder Offset handeln (siehe Zeitzonen und Offsets für weitere Informationen). Die Zeiteigenschaften werden in dieser Zeitzone interpretiert.

  offset Optional

  Ein Offset-String im gleichen Format wie der RFC 9557 Offset, jedoch mit optionalen Sekunden- und Subsekunden-Komponenten (±HH:mm:ss.sssssssss), der den Offset von UTC darstellt. Wenn weggelassen, wird er aus der Zeitzone und dem Datum-Uhrzeit berechnet. "Z" ist nicht erlaubt.

options Optional

Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

disambiguation Optional

Was zu tun ist, wenn das lokale Datum-Uhrzeit in der gegebenen Zeitzone zweideutig ist (es gibt mehr als eine Instant mit dieser lokalen Zeit, oder die lokale Zeit existiert nicht). Mögliche Werte sind "compatible", "earlier", "later" und "reject". Standardwert ist "compatible". Weitere Informationen zu diesen Werten finden Sie unter Zweideutigkeit und Lücken von lokaler Zeit zu UTC-Zeit.

offset Optional

Was zu tun ist, wenn der Offset in info explizit angegeben ist, aber der Offset für die gegebene Zeitzone in der angegebenen lokalen Zeit ungültig ist. Mögliche Werte sind "use", "ignore", "reject" und "prefer". Standardwert ist "reject". Weitere Informationen zu diesen Werten finden Sie unter Offset-Zweideutigkeit.

overflow Optional

Ein String, der das Verhalten spezifiziert, wenn eine Datumskomponente außerhalb des Bereichs liegt (bei Verwendung des Objekts info). Mögliche Werte sind:

"constrain" (Standard)

Die Datumskomponente wird auf den gültigen Bereich eingeschränkt.

"reject"

Ein RangeError wird ausgelöst, wenn die Datumskomponente außerhalb des Bereichs liegt.

Ein neues Temporal.ZonedDateTime-Objekt, das das von info angegebene Datum und die angegebene Zeit im angegebenen calendar und timeZone darstellt.

TypeError

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

• info ist kein Objekt oder String.
• options ist kein Objekt oder undefined.
• Die bereitgestellten Eigenschaften sind unzureichend, um ein Datum eindeutig zu bestimmen. In der Regel müssen Sie ein year (oder era und eraYear), einen month (oder monthCode) und einen day angeben.

RangeError

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

• Die bereitgestellten Eigenschaften, die dieselbe Komponente spezifizieren, sind inkonsistent.
• Die bereitgestellten nicht-numerischen Eigenschaften sind nicht gültig; zum Beispiel, wenn monthCode niemals ein gültiger Monatscode in diesem Kalender ist.
• Die bereitgestellten numerischen Eigenschaften sind außerhalb des Bereichs und options.overflow ist auf "reject" gesetzt.
• Die Uhrzeit nach Wanduhr ist in der Zeitzone nicht eindeutig und options.disambiguation ist auf "reject" gesetzt.
• Die Informationen sind nicht im darstellbaren Bereich, der ±10⁸ Tage oder etwa ±273,972.6 Jahre vom Unix-Epoch umfasst.

Beachten Sie, dass Temporal.ZonedDateTime.from() ISO 8601-Strings ablehnt, die keinen Zeitzonenbezeichner enthalten. Dies stellt sicher, dass die Zeitzone immer bekannt ist und verwendet werden kann, um unterschiedliche Offsets abzuleiten, wenn sich die lokale Zeit ändert.

Wenn Sie einen ISO 8601-String analysieren möchten, konstruieren Sie zuerst ein Temporal.Instant-Objekt und wandeln es dann in ein Temporal.ZonedDateTime-Objekt um. Sie können jede Zeitzone angeben, selbst wenn sie nicht mit dem ursprünglich im String angegebenen Offset übereinstimmt, und die lokale Zeit wird entsprechend angepasst.

const isoString = "2021-07-01T12:34:56+02:00";
const instant = Temporal.Instant.from(isoString);
const zdt = instant.toZonedDateTimeISO("America/New_York");
console.log(zdt.toString()); // "2021-07-01T06:34:56-04:00[America/New_York]"

Siehe Zweideutigkeit und Lücken von lokaler Zeit zu UTC-Zeit für eine Einführung in diese Situation.

const localTimeNotExist = "2024-03-10T02:05:00[America/New_York]";
// For non-existent times, "compatible" is equivalent to "later"
const zdt = Temporal.ZonedDateTime.from(localTimeNotExist);
console.log(zdt.toString()); // "2024-03-10T03:05:00-04:00[America/New_York]"

const zdt2 = Temporal.ZonedDateTime.from(localTimeNotExist, {
  disambiguation: "earlier",
});
console.log(zdt2.toString()); // "2024-03-10T01:05:00-05:00[America/New_York]"

const localTimeAmbiguous = "2024-11-03T01:05:00[America/New_York]";
// For ambiguous times, "compatible" is equivalent to "earlier"
const zdt3 = Temporal.ZonedDateTime.from(localTimeAmbiguous);
console.log(zdt3.toString()); // "2024-11-03T01:05:00-04:00[America/New_York]"

const zdt4 = Temporal.ZonedDateTime.from(localTimeAmbiguous, {
  disambiguation: "later",
});
console.log(zdt4.toString()); // "2024-11-03T01:05:00-05:00[America/New_York]"

Siehe Offset-Zweideutigkeit für eine Einführung in diese Situation.

const offsetAmbiguous = "2019-12-23T12:00:00-02:00[America/Sao_Paulo]";

Temporal.ZonedDateTime.from(offsetAmbiguous);
// RangeError: date-time can't be represented in the given time zone
Temporal.ZonedDateTime.from(offsetAmbiguous, { offset: "use" }).toString();
// "2019-12-23T11:00:00-03:00[America/Sao_Paulo]"
Temporal.ZonedDateTime.from(offsetAmbiguous, { offset: "ignore" }).toString();
// "2019-12-23T12:00:00-03:00[America/Sao_Paulo]"

Für weitere Beispiele, insbesondere im Hinblick auf verschiedene Kalender und Überlauf-Einstellungen, siehe Temporal.PlainDate.from() und Temporal.PlainTime.from().

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime()
• Temporal.ZonedDateTime.prototype.with()