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 dieser Jahr-Monat einem anderen Jahr-Monat wertmäßig entspricht (in einer Form, die durch Temporal.PlainYearMonth.from() konvertierbar ist), und false andernfalls. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datumwerte als auch ihrer Kalender verglichen. Daher können zwei Jahr-Monate aus verschiedenen Kalendern durch Temporal.PlainYearMonth.compare() als gleich angesehen werden, aber nicht durch equals().
Hinweis: PlainYearMonth-Objekte behalten einen referenzierten ISO-Tag im Auge, der ebenfalls im Vergleich verwendet wird. Dieser Tag wird automatisch festgelegt, wenn die Temporal.PlainYearMonth.from()-Methode verwendet wird, kann aber manuell mit dem Temporal.PlainYearMonth()-Konstruktor festgelegt werden, was dazu führen kann, dass zwei gleichwertige Jahr-Monate als unterschiedlich angesehen werden, wenn sie unterschiedliche Referenztage haben. Aus diesem Grund sollten Sie vermeiden, den Konstruktor direkt zu verwenden, und die from()-Methode bevorzugen.
Syntax
equals(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.PlainYearMonth-Instanz, die den anderen Jahr-Monat repräsentiert, der verglichen werden soll. Er wird mit demselben Algorithmus in einTemporal.PlainYearMonth-Objekt konvertiert wieTemporal.PlainYearMonth.from().
Rückgabewert
true, wenn dieser Jahr-Monat gleich other sowohl in ihrem Datumwert als auch in ihrem Kalender ist, andernfalls false.
Beispiele
Verwendung von equals()
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 # sec-temporal.plainyearmonth.prototype.equals |