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 umwandelbar durch Temporal.PlainMonthDay.from()), und sonst false. Sie werden sowohl durch ihre zugrunde liegenden ISO-Datumswerte als auch durch ihre Kalender verglichen.

Note: PlainMonthDay-Objekte behalten ein Referenz-ISO-Jahr, das auch in den Vergleich einfließt. Dieses Jahr wird automatisch gesetzt, wenn die Methode Temporal.PlainMonthDay.from() verwendet wird, kann aber manuell mit dem Temporal.PlainMonthDay() Konstruktor gesetzt werden, wodurch zwei äquivalente Monat-Tage als unterschiedlich angesehen werden können, wenn sie unterschiedliche Referenzjahre haben. Aus diesem Grund sollten Sie den Konstruktor nicht direkt verwenden und die from() Methode bevorzugen.

Syntax

js
equals(other)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainMonthDay Instanz, die den anderen Monat-Tag darstellt, der verglichen werden soll. Es wird in ein Temporal.PlainMonthDay Objekt umgewandelt, indem derselbe Algorithmus wie bei Temporal.PlainMonthDay.from() verwendet wird.

Rückgabewert

true, wenn dieser Monat-Tag dem other sowohl in seinem Datumswert als auch in seinem Kalender gleich 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