Spec-Zone.ru › JavaScript

Temporal.PlainYearMonth.prototype.equals()

Базовая Ограниченная доступность

Эта функция не является базовой, потому что она не работает в некоторых наиболее широко используемых браузерах.

Метод equals() экземпляров Temporal.PlainYearMonth возвращает true, если этот год-месяц эквивалентен по значению другому году-месяцу (в форме, преобразуемой с помощью Temporal.PlainYearMonth.from()), и false в противном случае. Сравнение проводится как по их основным значениям даты ISO, так и по их календарям, поэтому два года-месяца из разных календарей могут считаться равными с помощью Temporal.PlainYearMonth.compare() , но не с помощью equals().

Примечание: Объекты PlainYearMonth отслеживают эталонный день ISO, который также используется при сравнении. Этот день устанавливается автоматически при использовании метода Temporal.PlainYearMonth.from(), но может быть установлен вручную с помощью конструктора Temporal.PlainYearMonth(), что приводит к тому, что два эквивалентных года-месяца считаются разными, если у них разные эталонные дни. По этой причине следует избегать прямого использования конструктора и предпочесть метод from().

Синтаксис

equals(other)

Параметры

other
Строка, объект или экземпляр Temporal.PlainYearMonth, представляющий другой сравниваемый год-месяц. Он преобразуется в объект Temporal.PlainYearMonth с использованием того же алгоритма, что и Temporal.PlainYearMonth.from().

Возвращаемое значение

true, если этот год-месяц равен other как по значению даты, так и по календарю, false в противном случае.

Примеры

Использование 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

Спецификации

Спецификация
Temporal
# sec-temporal.plainyearmonth.prototype.equals

Совместимость с браузерами

Десктопные Мобильные Серверные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
equals
144
144
139
128
preview
144
139
95
Нет
Нет
144
Нет
1.4.0
2.7
26.0.0

Смотрите также

  • Temporal.PlainYearMonth
  • Temporal.PlainYearMonth.compare()

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal/PlainYearMonth/equals

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API