大网数据广告活动
Web 标准与前端开发

Temporal.PlainYearMonth.prototype.equals()

· 52CE 我爱测

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

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] PlainYearMonth objects 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 the from() 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.PlainYearMonth object using the same algorithm as Temporal/PlainYearMonth/from.

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。