Temporal.PlainYearMonth.prototype.equals()
equals() 方法用于 Temporal.PlainYearMonth 实例,当此年月与其另一个年月在值上等效时(可由 Temporal.PlainYearMonth.from() 转换的形式),返回 true,否则返回 false。它们会同时根据其底层的 ISO 日期值和日历进行比较,因此来自不同日历的两个年月可能在 Temporal.PlainYearMonth.compare() 中被视为相等,但在 equals() 中不被视为相等。
注意: PlainYearMonth 对象会跟踪一个参考 ISO 日期,该日期也用于比较。当使用 Temporal.PlainYearMonth.from() 方法时,该日期会自动设置;但可以使用 Temporal.PlainYearMonth() 构造函数手动设置,这会导致两个等效的年月因参考日期不同而被视为不同。因此,您应该避免直接使用构造函数,而优先使用 from() 方法。
语法
js
equals(other)
参数
其他-
要比较的另一个年月的字符串、对象或
Temporal.PlainYearMonth实例。它使用与Temporal.PlainYearMonth.from()相同的算法转换为Temporal.PlainYearMonth对象。
返回值
如果此年月在日期值和日历上都等于 other,则返回 true,否则返回 false。
示例
使用 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
规范
| 规范 |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.equals |
浏览器兼容性
加载中…