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 dem Wert eines anderen Monat-Tags entspricht (in einer Form, die durch Temporal.PlainMonthDay.from() konvertierbar ist), und false ansonsten. Sie werden sowohl nach ihren zugrunde liegenden ISO-Datumswerten als auch nach ihren Kalendern verglichen.

Hinweis: PlainMonthDay Objekte behalten ein Referenz-ISO-Jahr, welches ebenfalls im Vergleich verwendet wird. Dieses Jahr wird automatisch gesetzt, wenn die Methode Temporal.PlainMonthDay.from() verwendet wird, kann jedoch manuell mit dem Temporal.PlainMonthDay() Konstruktor festgelegt werden, was dazu führt, dass zwei äquivalente Monat-Tage als unterschiedlich betrachtet werden, wenn sie unterschiedliche Referenzjahre haben. Aus diesem Grund sollten Sie es vermeiden, den Konstruktor direkt zu 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 Monat-Tag repräsentiert, mit dem verglichen werden soll. Es wird mit demselben Algorithmus wie Temporal.PlainMonthDay.from() in ein Temporal.PlainMonthDay Objekt konvertiert.

Rückgabewert

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

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 proposal
# sec-temporal.plainmonthday.prototype.equals

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch