Temporal.PlainYearMonth.prototype.equals()

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức equals() của các thực thể Temporal.PlainYearMonth trả về true nếu year-month này có giá trị tương đương với một year-month khác (ở dạng có thể chuyển đổi bởi Temporal.PlainYearMonth.from()), và false trong trường hợp còn lại. Chúng được so sánh cả theo giá trị ngày ISO cơ bản lẫn lịch, vì vậy hai year-month từ các lịch khác nhau có thể được coi là bằng nhau bởi Temporal.PlainYearMonth.compare() nhưng không bởi equals().

Note: Các đối tượng PlainYearMonth theo dõi một ngày ISO tham chiếu, cũng được dùng trong quá trình so sánh. Ngày này được tự động đặt khi sử dụng phương thức Temporal.PlainYearMonth.from(), nhưng có thể được đặt thủ công bằng constructor Temporal.PlainYearMonth(), khiến hai year-month tương đương bị coi là khác nhau nếu chúng có các ngày tham chiếu khác nhau. Vì lý do này, bạn nên tránh dùng constructor trực tiếp và ưu tiên phương thức from().

Cú pháp

equals(other)

Tham số

other: Một chuỗi, một đối tượng, hoặc một thực thể Temporal.PlainYearMonth đại diện cho year-month khác cần so sánh. Nó được chuyển đổi thành đối tượng Temporal.PlainYearMonth bằng thuật toán tương tự như Temporal.PlainYearMonth.from().

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