Temporal.PlainYearMonth.prototype.equals()

Limited availability

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

Die equals() Methode von Temporal.PlainYearMonth Instanzen gibt true zurück, wenn dieser Jahr-Monat in seinem Wert gleich einem anderen Jahr-Monat ist (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist), und false andernfalls. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datenwerte als auch ihrer Kalender verglichen, so dass zwei Jahr-Monate aus unterschiedlichen Kalendern von Temporal.PlainYearMonth.compare() als gleich angesehen werden können, jedoch nicht von equals().

Hinweis: PlainYearMonth Objekte behalten einen Referenz-ISO-Tag, der ebenfalls bei der Vergleichsoperation verwendet wird. Dieser Tag wird automatisch beim Verwenden der Temporal.PlainYearMonth.from() Methode gesetzt, kann jedoch manuell mit dem Temporal.PlainYearMonth() Konstruktor gesetzt werden, was dazu führen kann, dass zwei gleichwertige Jahr-Monate als unterschiedlich angesehen werden, wenn sie verschiedene Referenztage haben. Aus diesem Grund sollten Sie vermeiden, den Konstruktor direkt zu verwenden und stattdessen die from() Methode bevorzugen.

Syntax

equals(other)

Parameter

other: Ein String, ein Objekt oder eine Temporal.PlainYearMonth Instanz, die den anderen Jahr-Monat darstellt, der verglichen werden soll. Es wird mit dem gleichen Algorithmus wie Temporal.PlainYearMonth.from() in ein Temporal.PlainYearMonth Objekt konvertiert.

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