Temporal.PlainYearMonth

Beschreibung

Ein PlainYearMonth ist im Wesentlichen der Jahr-Monat-Teil eines Temporal.PlainDate-Objekts, ohne den Tag.

RFC 9557 Format

PlainYearMonth-Objekte können im RFC 9557-Format serialisiert und geparst werden, eine Erweiterung des ISO 8601 / RFC 3339-Formats. Der String hat die folgende Form (Leerzeichen dienen nur der Lesbarkeit und sollten im tatsächlichen String nicht vorhanden sein):

YYYY-MM-DD [u-ca=calendar_id]

YYYY

Entweder eine vierstellige Zahl oder eine sechsstellige Zahl mit einem +- oder --Vorzeichen.

MM

Eine zweistellige Zahl von 01 bis 12.

DD Optional

Eine zweistellige Zahl von 01 bis 31. Sie ist für nicht-ISO-Kalender erforderlich und ansonsten optional. Bei Weglassen sieht der String wie YYYY-MM oder YYYYMM aus. Beachten Sie, dass der tatsächlich gespeicherte Referenztag von dem abweichen kann, den Sie angeben, aber der repräsentierte Jahr-Monat bleibt derselbe. Siehe Temporal.PlainYearMonth.from() für weitere Informationen. Die YYYY, MM und DD-Komponenten können durch - oder nichts getrennt sein.

[u-ca=calendar_id] Optional

Ersetzen Sie calendar_id durch den zu verwendenden Kalender. Siehe Intl.supportedValuesOf() für eine Liste häufig unterstützter Kalendertypen. Standardmäßig [u-ca=iso8601]. Kann ein kritisches Flag haben, indem Sie dem Schlüssel ein ! voranstellen: zum Beispiel [!u-ca=iso8601]. Dieses Flag teilt anderen Systemen im Allgemeinen mit, dass es nicht ignoriert werden kann, wenn sie es nicht unterstützen. Der Temporal-Parser wirft einen Fehler, wenn die Anmerkungen zwei oder mehr Kalender-Anmerkungen enthalten und eine davon kritisch ist. Beachten Sie, dass das YYYY-MM-DD immer als ISO 8601-Kalenderdatum interpretiert und dann in den angegebenen Kalender konvertiert wird.

Als Eingabe können Sie optional die Zeit, den Offset und den Zeitzonen-Bezeichner im gleichen Format wie PlainDateTime einfügen, aber sie werden ignoriert. Andere Anmerkungen im [key=value]-Format werden ebenfalls ignoriert und dürfen nicht das kritische Flag haben.

Beim Serialisieren können Sie konfigurieren, ob die Kalender-ID angezeigt werden soll und ob ein kritisches Flag dafür hinzugefügt werden soll.

Konstruktor

Temporal.PlainYearMonth() Experimentell

Erstellt ein neues Temporal.PlainYearMonth-Objekt, indem direkt die zugrunde liegenden Daten bereitgestellt werden.

Statische Methoden

Temporal.PlainYearMonth.compare()

Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob der erste Jahr-Monat vor, gleich oder nach dem zweiten Jahr-Monat liegt. Äquivalent zum Vergleich ihrer zugrunde liegenden ISO 8601-Daten. Zwei Jahr-Monate aus verschiedenen Kalendern können als gleich angesehen werden, wenn sie am selben ISO-Datum beginnen.

Temporal.PlainYearMonth.from()

Erstellt ein neues Temporal.PlainYearMonth-Objekt aus einem anderen Temporal.PlainYearMonth-Objekt, einem Objekt mit Jahr- und Monatseigenschaften oder einem RFC 9557-String.

Instanz-Eigenschaften

Diese Eigenschaften sind auf Temporal.PlainYearMonth.prototype definiert und werden von allen Temporal.PlainYearMonth-Instanzen geteilt.

Temporal.PlainYearMonth.prototype.calendarId

Gibt einen String zurück, der den zur Interpretation des internen ISO 8601-Datums verwendeten Kalender darstellt.

Temporal.PlainYearMonth.prototype.constructor

Die Konstruktorfunktion, die das Instanz-Objekt erstellt hat. Für Temporal.PlainYearMonth-Instanzen ist der Anfangswert der Temporal.PlainYearMonth()-Konstruktor.

Temporal.PlainYearMonth.prototype.daysInMonth

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage im Monat dieses Datums darstellt. Kalender-abhängig.

Temporal.PlainYearMonth.prototype.daysInYear

Gibt eine positive Ganzzahl zurück, die die Anzahl der Tage im Jahr dieses Datums darstellt. Kalender-abhängig. Für den ISO 8601-Kalender sind dies 365 oder 366 in einem Schaltjahr.

Temporal.PlainYearMonth.prototype.era

Gibt einen kalender-spezifischen Kleinbuchstaben-String zurück, der die Ära dieses Jahr-Monats darstellt, oder undefined, wenn der Kalender keine Ären verwendet (z.B. ISO 8601). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, so wie es year tut. Kalender-abhängig. Im Gregorianischen ist es entweder "gregory" oder "gregory-inverse".

Temporal.PlainYearMonth.prototype.eraYear

Gibt eine nicht-negative Ganzzahl zurück, die das Jahr dieses Jahr-Monats innerhalb der Ära darstellt, oder undefined, wenn der Kalender keine Ären verwendet (z.B. ISO 8601). Der Jahresindex beginnt normalerweise bei 1 (häufiger) oder 0, und Jahre in einer Ära können mit der Zeit abnehmen (z.B. Gregorianischer BCE). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, so wie es year tut. Kalender-abhängig.

Temporal.PlainYearMonth.prototype.inLeapYear

Gibt ein boolean zurück, das angibt, ob dieser Jahr-Monat in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das mehr Tage hat (aufgrund eines Schaltstags oder Schaltmonats) als ein gewöhnliches Jahr. Kalender-abhängig.

Temporal.PlainYearMonth.prototype.month

Gibt eine positive Ganzzahl zurück, die den 1-basierten Monatsindex im Jahr dieses Jahr-Monats darstellt. Der erste Monat dieses Jahres ist 1, und der letzte Monat ist der monthsInYear. Kalender-abhängig. Beachten Sie, dass der Index im Gegensatz zu Date.prototype.getMonth() 1-basiert ist. Wenn der Kalender Schaltmonate hat, dann kann der Monat mit dem gleichen monthCode unterschiedliche month-Indizes für verschiedene Jahre haben.

Temporal.PlainYearMonth.prototype.monthCode

Gibt einen kalender-spezifischen String zurück, der den Monat dieses Jahr-Monats darstellt. Kalender-abhängig. Normalerweise ist es M plus eine zweistellige Monatszahl. Für Schaltmonate ist es der Code des vorherigen Monats gefolgt von L. Wenn der Schaltmonat der erste Monat des Jahres ist, ist der Code M00L.

Temporal.PlainYearMonth.prototype.monthsInYear

Gibt eine positive Ganzzahl zurück, die die Anzahl der Monate im Jahr dieses Datums darstellt. Kalender-abhängig. Für den ISO 8601-Kalender sind dies immer 12, aber in anderen Kalendersystemen kann es abweichen.

Temporal.PlainYearMonth.prototype.year

Gibt eine Ganzzahl zurück, die die Anzahl der Jahre dieses Jahr-Monats relativ zum Beginn eines kalender-spezifischen Epochejahres darstellt. Kalender-abhängig. Normalerweise ist Jahr 1 entweder das erste Jahr der letzten Ära oder das ISO 8601-Jahr 0001. Wenn die Epoche in der Mitte des Jahres liegt, wird dieses Jahr denselben Wert vor und nach dem Startdatum der Ära haben.

Temporal.PlainYearMonth.prototype[Symbol.toStringTag]

Der Anfangswert der [Symbol.toStringTag]-Eigenschaft ist der String "Temporal.PlainYearMonth". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Instanz-Methoden

Temporal.PlainYearMonth.prototype.add()

Gibt ein neues Temporal.PlainYearMonth-Objekt zurück, das diesen Jahr-Monat, verschoben um eine angegebene Dauer (in einer Form, die von Temporal.Duration.from() konvertierbar ist), darstellt.

Temporal.PlainYearMonth.prototype.equals()

Gibt true zurück, wenn dieser Jahr-Monat einem anderen Jahr-Monat (in einer Form, die von Temporal.PlainYearMonth.from() konvertierbar ist) wertmäßig entspricht, und false sonst. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datenwerte als auch ihrer Kalender verglichen, sodass zwei Jahr-Monate aus verschiedenen Kalendern durch Temporal.PlainYearMonth.compare() gleich angesehen werden können, aber nicht durch equals().

Temporal.PlainYearMonth.prototype.since()

Gibt ein neues Temporal.Duration-Objekt zurück, das die Dauer von einem anderen Jahr-Monat (in einer Form, die von Temporal.PlainYearMonth.from() konvertierbar ist) bis zu diesem Jahr-Monat darstellt. Die Dauer ist positiv, wenn der andere Monat vor diesem Monat liegt, und negativ, wenn danach.

Temporal.PlainYearMonth.prototype.subtract()

Gibt ein neues Temporal.PlainYearMonth-Objekt zurück, das diesen Jahr-Monat, rückwärts verschoben um eine angegebene Dauer (in einer Form, die von Temporal.Duration.from() konvertierbar ist), darstellt.

Temporal.PlainYearMonth.prototype.toJSON()

Gibt einen String zurück, der diesen Jahr-Monat im gleichen RFC 9557 Format wie bei der Aufruf von toString() darstellt. Soll implizit von JSON.stringify() aufgerufen werden.

Temporal.PlainYearMonth.prototype.toLocaleString()

Gibt einen String mit einer sprachensensitiven Darstellung dieses Jahr-Monats zurück.

Temporal.PlainYearMonth.prototype.toPlainDate()

Gibt ein neues Temporal.PlainDate-Objekt zurück, das diesen Jahr-Monat und einen angegebenen Tag im gleichen Kalendersystem darstellt.

Temporal.PlainYearMonth.prototype.toString()

Gibt einen String zurück, der diesen Jahr-Monat im RFC 9557 Format darstellt.

Temporal.PlainYearMonth.prototype.until()

Gibt ein neues Temporal.Duration-Objekt zurück, das die Dauer von diesem Jahr-Monat bis zu einem anderen Jahr-Monat (in einer Form, die von Temporal.PlainYearMonth.from() konvertierbar ist) darstellt. Die Dauer ist positiv, wenn der andere Monat nach diesem Monat liegt, und negativ, wenn davor.

Temporal.PlainYearMonth.prototype.valueOf()

Wirft einen TypeError, der verhindert, dass Temporal.PlainYearMonth-Instanzen implizit in Primitive umgewandelt werden, wenn sie in arithmetischen oder Vergleichsoperationen verwendet werden.

Temporal.PlainYearMonth.prototype.with()

Gibt ein neues Temporal.PlainYearMonth-Objekt zurück, das diesen Jahr-Monat mit einigen Feldern darstellt, die durch neue Werte ersetzt werden.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal
• Temporal.PlainDate
• Temporal.PlainMonthDay