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 Instanzen des Temporal.PlainYearMonth gibt true zurück, wenn diese Jahr-Monat-Wert mit einem anderen Jahr-Monat, der durch Temporal.PlainYearMonth.from() konvertierbar ist, identisch ist, und false ansonsten. Sie werden sowohl anhand ihrer zugrunde liegenden ISO-Datenwerte als auch ihrer Kalender verglichen. Daher können zwei Jahr-Monate aus unterschiedlichen Kalendern von Temporal.PlainYearMonth.compare() als gleich angesehen werden, aber nicht von equals().
Hinweis:>PlainYearMonth Objekte verfolgen einen Referenz-ISO-Tag, der ebenfalls im Vergleich verwendet wird. Dieser Tag wird automatisch festgelegt, wenn die Methode Temporal.PlainYearMonth.from() verwendet wird, kann aber manuell mit dem Temporal.PlainYearMonth() Konstruktor festgelegt werden. Dadurch können zwei äquivalente Jahr-Monate als unterschiedlich angesehen werden, wenn sie unterschiedliche Referenztage haben. Aus diesem Grund sollten Sie es vermeiden, den Konstruktor direkt zu verwenden und stattdessen die from() Methode bevorzugen.
Syntax
equals(other)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.PlainYearMonthInstanz, die das andere Jahr-Monat zum Vergleichen darstellt. Es wird mit demselben Algorithmus in einTemporal.PlainYearMonthObjekt umgewandelt wieTemporal.PlainYearMonth.from().
Rückgabewert
true, wenn dieses Jahr-Monat sowohl in ihrem Datumswert als auch in ihrem Kalender gleich other ist, false andernfalls.
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 |