The equals() method of Temporal.PlainYearMonth instances returns true if this year-month is equivalent in value to another year-month (in a form convertible by Temporal/PlainYearMonth/from), and false otherwise. They are compared both by their underlying ISO date values and their calendars, so two year-months from different calendars may be considered equal by Temporal/PlainYearMonth/compare but not by equals().
[!NOTE]
PlainYearMonthobjects keep track of a reference ISO day, which is also used in the comparison. This day is automatically set when using the Temporal/PlainYearMonth/from method, but can be set manually using the Temporal/PlainYearMonth/PlainYearMonth constructor, causing two equivalent year-months to be considered different if they have different reference days. For this reason, you should avoid using the constructor directly and prefer thefrom()method.
Syntax
equals(other)
Parameters
other- : A string, an object, or a Temporal.PlainYearMonth instance representing the other year-month to compare. It is converted to a
Temporal.PlainYearMonthobject using the same algorithm as Temporal/PlainYearMonth/from.
- : A string, an object, or a Temporal.PlainYearMonth instance representing the other year-month to compare. It is converted to a
Return value
true if this year-month is equal to other both in their date value and their calendar, false otherwise.
Examples
Using 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
Specifications
Browser compatibility
See also
- Temporal.PlainYearMonth
- Temporal/PlainYearMonth/compare
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
