Temporal.PlainYearMonth.prototype.equals()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Methode equals() von Temporal.PlainYearMonth Instanzen gibt true zurück, wenn dieses Jahr-Monat im Wert einem anderen Jahr-Monat (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist) entspricht, und ansonsten false. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datenwerte als auch ihrer Kalender verglichen, sodass zwei Jahr-Monate aus unterschiedlichen Kalendern möglicherweise von Temporal.PlainYearMonth.compare() als gleich angesehen werden, aber nicht von equals().

Hinweis: PlainYearMonth-Objekte verfolgen einen Referenz-ISO-Tag, der ebenfalls im Vergleich verwendet wird. Dieser Tag wird automatisch gesetzt, wenn Sie die Methode Temporal.PlainYearMonth.from() verwenden, kann aber manuell über den Konstruktor Temporal.PlainYearMonth() gesetzt werden, wodurch zwei gleichwertige Jahr-Monate als unterschiedlich angesehen werden, wenn sie unterschiedliche Referenztage haben. Aus diesem Grund sollten Sie es vermeiden, den Konstruktor direkt zu verwenden, und die from() Methode bevorzugen.

Syntax

equals(other)

Parameter

other: Ein String, ein Objekt oder eine Temporal.PlainYearMonth Instanz, die das andere Jahr-Monat zum Vergleichen darstellt. Es wird mithilfe des gleichen Algorithmus wie Temporal.PlainYearMonth.from() in ein Temporal.PlainYearMonth Objekt umgewandelt.

const ym1 = Temporal.PlainYearMonth.from("2021-08");
const ym2 = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
console.log(ym1.equals(ym2)); // true

const ym3 = Temporal.PlainYearMonth.from("2021-08-01[u-ca=japanese]");
console.log(ym1.equals(ym3)); // false

const ym4 = Temporal.PlainYearMonth.from("2021-09");
console.log(ym1.equals(ym4)); // false