Temporal.PlainYearMonth.from()

info

Eines der folgenden:

• Eine Instanz von Temporal.PlainYearMonth, die eine Kopie der Instanz erstellt.
• Ein RFC 9557-String, der ein Datum und optional einen Kalender enthält. Wenn der Kalender nicht iso8601 ist, ist ein Tag erforderlich.
• Ein Objekt, das die folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

  calendar Optional

  Ein String, der der Eigenschaft calendarId entspricht. Siehe Intl.supportedValuesOf() für eine Liste von allgemein unterstützten Kalendertypen. Standardmäßig "iso8601". Alle anderen Eigenschaften werden in diesem Kalendersystem interpretiert (im Gegensatz zum Temporal.PlainYearMonth()-Konstruktor, der die Werte im ISO-Kalendersystem interpretiert).

  era und eraYear

  Ein String und eine ganze Zahl, die den Eigenschaften era und eraYear entsprechen. Werden nur verwendet, wenn das Kalendersystem Äras hat. era und eraYear müssen gleichzeitig angegeben werden. Wenn sie nicht angegeben werden, muss year bereitgestellt werden. Wenn alle era, eraYear und year angegeben werden, müssen sie konsistent sein.

  month

  Entspricht der Eigenschaft month. Muss positiv sein, unabhängig von der overflow-Option.

  monthCode

  Entspricht der Eigenschaft monthCode. Wenn sie nicht angegeben wird, muss month bereitgestellt werden. Wenn sowohl month als auch monthCode angegeben sind, müssen sie konsistent sein.

  year

  Entspricht der Eigenschaft year.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

Ein String, der das Verhalten angibt, wenn eine Datumskomponente außerhalb des Bereichs liegt (bei Verwendung des Objekt-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.PlainYearMonth-Objekt, das das Jahr und den Monat repräsentiert, die von info im angegebenen calendar spezifiziert werden.

Jedes PlainYearMonth speichert intern ein vollständiges ISO 8601-Datum, das im Zielkalender dasselbe Jahr-Monat hat wie das angezeigte. Der Referenztag ist sichtbar, wenn er mit toString() serialisiert wird, was ein ISO-Datum ausgibt. Der Referenztag wird willkürlich, aber konsistent gewählt; das heißt, jedes (year, month)-Paar wird immer auf denselben ISO-Referenztag abgebildet. Der in der Eingabe bereitgestellte Tag wird nicht verwendet. Stattdessen wird der Referenztag immer als der erste gültige Tag des Monats gewählt.

Diese Referenztag-Kanonisierung stellt sicher, dass equals() die zugrunde liegenden ISO-Daten ohne zusätzliche Berechnung direkt vergleichen kann.

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 nicht ausreichend, um ein Datum eindeutig zu bestimmen. Normalerweise müssen Sie ein year (oder era und eraYear) und einen month (oder einen monthCode) 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 Info liegt nicht im darstellbaren Bereich, der ±(10⁸ + 1) Tage oder etwa ±273,972.6 Jahre vom Unix-Epoch umfasst.

Standardmäßig werden Werte außerhalb des Bereichs auf den gültigen Bereich eingeschränkt.

const ym1 = Temporal.PlainYearMonth.from({ year: 2021, month: 13 });
console.log(ym1.toString()); // 2021-12

// 5732 is not a Hebrew leap year, so a different monthCode is chosen
const ym2 = Temporal.PlainYearMonth.from({
  year: 5732,
  monthCode: "M05L",
  calendar: "hebrew",
});
console.log(ym2.toLocaleString("en-US", { calendar: "hebrew" })); // Adar 5732
const underlyingDate = Temporal.PlainDate.from(ym2.toString());
console.log(underlyingDate.year, underlyingDate.monthCode); // 5732 M06

Sie können dieses Verhalten ändern, um stattdessen einen Fehler auszulösen:

Temporal.PlainYearMonth.from({ year: 2021, month: 13 }, { overflow: "reject" });
// RangeError: date value "month" not in 1..12: 13

• Temporal.PlainYearMonth
• Temporal.PlainYearMonth()
• Temporal.PlainYearMonth.prototype.with()