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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
equals
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch