Temporal.PlainMonthDay.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.PlainMonthDay-Instanzen gibt true zurück, wenn dieser Monat-Tag im Wert einem anderen Monat-Tag entspricht (in einer Form, die durch Temporal.PlainMonthDay.from() konvertierbar ist), und false andernfalls. Sie werden sowohl an ihren zugrundeliegenden ISO-Datenwerten als auch an ihren Kalendern verglichen.

Hinweis: PlainMonthDay-Objekte behalten ein Referenz-ISO-Jahr bei, das ebenfalls im Vergleich verwendet wird. Dieses Jahr wird automatisch festgelegt, wenn die Methode Temporal.PlainMonthDay.from() verwendet wird, kann jedoch manuell mit dem Temporal.PlainMonthDay()-Konstruktor festgelegt werden. Dadurch können zwei äquivalente Monat-Tage als unterschiedlich betrachtet werden, wenn sie unterschiedliche Referenzjahre haben. Aus diesem Grund sollten Sie den Konstruktor nicht direkt verwenden und stattdessen die from()-Methode bevorzugen.

Syntax

js
equals(other)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainMonthDay-Instanz, die den anderen zu vergleichenden Monat-Tag darstellt. Es wird unter Verwendung desselben Algorithmus wie Temporal.PlainMonthDay.from() in ein Temporal.PlainMonthDay-Objekt konvertiert.

Rückgabewert

true, wenn dieser Monat-Tag sowohl im Datum als auch im Kalender gleich other ist, andernfalls false.

Beispiele

Verwendung von equals()

js
const md1 = Temporal.PlainMonthDay.from("2021-08-01");
const md2 = Temporal.PlainMonthDay.from({ year: 2020, month: 8, day: 1 }); // Year doesn't matter
console.log(md1.equals(md2)); // true

const md3 = Temporal.PlainMonthDay.from("2021-08-01[u-ca=japanese]");
console.log(md1.equals(md3)); // false

const md4 = Temporal.PlainMonthDay.from("2021-08-02");
console.log(md1.equals(md4)); // false

Spezifikationen

Specification
Temporal
# sec-temporal.plainmonthday.prototype.equals

Browser-Kompatibilität

Siehe auch