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 mithilfe des RFC-9557-Formats serialisiert und geparst werden, einer Erweiterung des Formats ISO 8601 / RFC 3339. Die Zeichenkette hat die folgende Form (Leerzeichen dienen nur der besseren Lesbarkeit und dürfen in der tatsächlichen Zeichenkette nicht enthalten 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. Wird sie ausgelassen, sieht die Zeichenkette wie YYYY-MM oder YYYYMM aus. Beachten Sie, dass der tatsächlich gespeicherte Referenztag von dem von Ihnen angegebenen abweichen kann, das repräsentierte Jahr-Monat jedoch gleich bleibt. Weitere Informationen finden Sie unter Temporal.PlainYearMonth.from(). Die Komponenten YYYY, MM und DD können durch - oder gar nicht getrennt werden.

[u-ca=calendar_id] Optional

Ersetzen Sie calendar_id durch den zu verwendenden Kalender. Eine Liste häufig unterstützter Kalendertypen finden Sie unter Intl.supportedValuesOf(). Standardmäßig wird [u-ca=iso8601] verwendet. Ein kritisches Flag kann vorangestellt werden, indem dem Schlüssel ! vorangestellt wird: beispielsweise [!u-ca=iso8601]. Dieses Flag teilt anderen Systemen im Allgemeinen mit, dass es nicht ignoriert werden darf, wenn sie es nicht unterstützen. Der Temporal-Parser löst einen Fehler aus, wenn die Annotationen zwei oder mehr Kalenderannotation enthalten und eine davon kritisch ist. Beachten Sie, dass 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 die Zeitzonenkennung im selben Format wie bei PlainDateTime einfügen, sie werden jedoch ignoriert. Andere Annotationen im Format [key=value] werden ebenfalls ignoriert und dürfen nicht das kritische Flag enthalten.

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

Konstruktor

Temporal.PlainYearMonth()

Erstellt ein neues Temporal.PlainYearMonth-Objekt durch direkte Angabe der zugrunde liegenden Daten.

Statische Methoden

Temporal.PlainYearMonth.compare()

Gibt eine Zahl (-1, 0 oder 1) zurück, die angibt, ob das erste Jahr-Monat vor, gleich oder nach dem zweiten Jahr-Monat liegt. Entspricht dem Vergleich ihrer zugrunde liegenden ISO-8601-Daten. Zwei Jahr-Monate aus unterschiedlichen Kalendern können als gleich betrachtet 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 year- und month-Eigenschaften oder einer RFC-9557-Zeichenkette.

Instanzeigenschaften

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

Temporal.PlainYearMonth.prototype.calendarId

Gibt eine Zeichenkette zurück, die den Kalender repräsentiert, der zur Interpretation des internen ISO-8601-Datums verwendet wird.

Temporal.PlainYearMonth.prototype.constructor

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

Temporal.PlainYearMonth.prototype.daysInMonth

Gibt eine positive ganze Zahl zurück, die die Anzahl der Tage im Monat dieses Datums repräsentiert. Abhängig vom Kalender.

Temporal.PlainYearMonth.prototype.daysInYear

Gibt eine positive ganze Zahl zurück, die die Anzahl der Tage im Jahr dieses Datums repräsentiert. Abhängig vom Kalender. Für den ISO-8601-Kalender sind es 365 beziehungsweise 366 in einem Schaltjahr.

Temporal.PlainYearMonth.prototype.era

Gibt eine kalenderspezifische Zeichenkette in Kleinbuchstaben zurück, die die Ära dieses Jahr-Monats repräsentiert, oder undefined, wenn der Kalender keine Ären verwendet (z. B. ISO 8601). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, genauso wie year. Abhängig vom Kalender. Für Gregorian ist es entweder "ce" oder "bce".

Temporal.PlainYearMonth.prototype.eraYear

Gibt eine nicht negative ganze Zahl zurück, die das Jahr dieses Jahr-Monats innerhalb der Ära repräsentiert, oder undefined, wenn der Kalender keine Ären verwendet (z. B. ISO 8601). Der Jahresindex beginnt üblicherweise bei 1 (häufiger) oder 0, und Jahre innerhalb einer Ära können mit der Zeit abnehmen (z. B. Gregorian BCE). era und eraYear identifizieren zusammen ein Jahr in einem Kalender eindeutig, genauso wie year. Abhängig vom Kalender.

Temporal.PlainYearMonth.prototype.inLeapYear

Gibt einen booleschen Wert zurück, der angibt, ob dieses Jahr-Monat in einem Schaltjahr liegt. Ein Schaltjahr ist ein Jahr, das aufgrund eines Schalttags oder Schaltmonats mehr Tage als ein gewöhnliches Jahr hat. Abhängig vom Kalender.

Temporal.PlainYearMonth.prototype.month

Gibt eine positive ganze Zahl zurück, die den bei 1 beginnenden Monatsindex im Jahr dieses Jahr-Monats repräsentiert. Der erste Monat dieses Jahres ist 1, und der letzte Monat ist monthsInYear. Abhängig vom Kalender. Beachten Sie, dass der Index im Gegensatz zu Date.prototype.getMonth() bei 1 beginnt. Falls der Kalender Schaltmonate enthält, kann der Monat mit demselben monthCode für unterschiedliche Jahre unterschiedliche month-Indizes haben.

Temporal.PlainYearMonth.prototype.monthCode

Gibt eine kalenderspezifische Zeichenkette zurück, die den Monat dieses Jahr-Monats repräsentiert. Abhängig vom Kalender. Normalerweise besteht sie aus M gefolgt von einer zweistelligen Monatsnummer. Bei Schaltmonaten ist es der Code des vorherigen Monats, gefolgt von L. Falls der Schaltmonat der erste Monat des Jahres ist, lautet der Code M00L.

Temporal.PlainYearMonth.prototype.monthsInYear

Gibt eine positive ganze Zahl zurück, die die Anzahl der Monate im Jahr dieses Datums repräsentiert. Abhängig vom Kalender. Für den ISO-8601-Kalender ist dies immer 12, kann sich jedoch in anderen Kalendersystemen unterscheiden.

Temporal.PlainYearMonth.prototype.year

Gibt eine ganze Zahl zurück, die die Anzahl der Jahre dieses Jahr-Monats relativ zum Beginn eines kalenderspezifischen Epochenjahrs repräsentiert. Abhängig vom Kalender. Üblicherweise ist Jahr 1 entweder das erste Jahr der jüngsten Ära oder das ISO-8601-Jahr 0001. Falls die Epoche in der Mitte des Jahres liegt, hat dieses Jahr vor und nach dem Anfangsdatum der Ära denselben Wert.

Temporal.PlainYearMonth.prototype[Symbol.toStringTag]

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

Instanzmethoden

Temporal.PlainYearMonth.prototype.add()

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

Temporal.PlainYearMonth.prototype.equals()

Gibt true zurück, wenn dieses Jahr-Monat im Wert einem anderen Jahr-Monat entspricht (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist), andernfalls false. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datumswerte als auch ihrer Kalender verglichen. Daher können zwei Jahr-Monate aus unterschiedlichen Kalendern durch Temporal.PlainYearMonth.compare() als gleich betrachtet werden, jedoch 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 durch Temporal.PlainYearMonth.from() konvertierbar ist) bis zu diesem Jahr-Monat repräsentiert. Die Dauer ist positiv, wenn der andere Monat vor diesem Monat liegt, und negativ, wenn er danach liegt.

Temporal.PlainYearMonth.prototype.subtract()

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

Temporal.PlainYearMonth.prototype.toJSON()

Gibt eine Zeichenkette zurück, die dieses Jahr-Monat im selben RFC-9557-Format wie ein Aufruf von toString() repräsentiert. Sie ist dazu vorgesehen, implizit durch JSON.stringify() aufgerufen zu werden.

Temporal.PlainYearMonth.prototype.toLocaleString()

Gibt eine Zeichenkette mit einer sprachsensitiven Darstellung dieses Jahr-Monats zurück.

Temporal.PlainYearMonth.prototype.toPlainDate()

Gibt ein neues Temporal.PlainDate-Objekt zurück, das dieses Jahr-Monat und einen angegebenen Tag im selben Kalendersystem repräsentiert.

Temporal.PlainYearMonth.prototype.toString()

Gibt eine Zeichenkette zurück, die dieses Jahr-Monat im RFC-9557-Format repräsentiert.

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 repräsentiert (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist). Die Dauer ist positiv, wenn der andere Monat nach diesem Monat liegt, und negativ, wenn er davor liegt.

Temporal.PlainYearMonth.prototype.valueOf()

Löst einen TypeError aus, wodurch verhindert wird, dass Temporal.PlainYearMonth-Instanzen bei der Verwendung in arithmetischen oder Vergleichsoperationen implizit in Primitive konvertiert werden.

Temporal.PlainYearMonth.prototype.with()

Gibt ein neues Temporal.PlainYearMonth-Objekt zurück, das dieses Jahr-Monat mit einigen durch neue Werte ersetzten Feldern repräsentiert.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal
• Temporal.PlainDate
• Temporal.PlainMonthDay