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 equals() Methode von Temporal.PlainYearMonth Instanzen gibt true zurück, wenn dieses Jahr-Monat äquivalent zu einem anderen Jahr-Monat ist (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist), und false andernfalls. Sie werden sowohl durch ihre zugrunde liegenden ISO-Datenwerte als auch durch ihre Kalender verglichen. Daher können zwei Jahr-Monate aus verschiedenen Kalendern von Temporal.PlainYearMonth.compare() als gleich angesehen werden, jedoch nicht von equals().

Note: PlainYearMonth Objekte behalten einen Referenz-ISO-Tag bei, der auch im Vergleich verwendet wird. Dieser Tag wird automatisch gesetzt, wenn die Temporal.PlainYearMonth.from() Methode verwendet wird, kann jedoch manuell mit dem Temporal.PlainYearMonth() Konstruktor gesetzt werden, was dazu führen kann, dass zwei äquivalente Jahr-Monate als unterschiedlich angesehen werden, wenn sie unterschiedliche Referenztage haben. Aus diesem Grund sollten Sie die direkte Verwendung des Konstruktors vermeiden und die from() Methode bevorzugen.

Syntax

js
equals(other)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainYearMonth Instanz, die das andere Jahr-Monat darstellt, mit dem verglichen werden soll. Es wird mit demselben Algorithmus zu einem Temporal.PlainYearMonth Objekt konvertiert wie Temporal.PlainYearMonth.from().

Rückgabewert

true, wenn dieses Jahr-Monat identisch ist zu other sowohl in ihrem Datumswert als auch ihrem Kalender, false andernfalls.

Beispiele

Verwendung von equals()

js
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

Spezifikationen

Specification
Temporal proposal
# sec-temporal.plainyearmonth.prototype.equals

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch