Temporal.ZonedDateTime.prototype.equals()

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

Синтаксис

equals(other)

Параметры

other

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

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

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

Обратите внимание, что часовые пояса канонизируются перед сравнением, поэтому, если их идентификаторы часовых поясов названы и определяют один и тот же часовой пояс, то они будут считаться одинаковыми, даже если точные имена могут быть псевдонимами друг друга. Идентификаторы смещения сравниваются по значениям смещения, которые они представляют. Идентификаторы смещения никогда не будут равны именованным идентификаторам, даже если часовой пояс именованного идентификатора всегда использует это смещение.

Примеры

Использование equals()

// Asia/Kolkata and Asia/Calcutta are aliases of each other
const dt1 = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56+05:30[Asia/Kolkata]",
);
const dt2 = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56+05:30[Asia/Calcutta]",
);
console.log(dt1.equals(dt2)); // true

const dt3 = Temporal.ZonedDateTime.from("2021-07-01T12:34:56+05:30[+05:30]");
console.log(dt1.equals(dt3)); // false

const dt4 = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56+05:30[Asia/Kolkata][u-ca=buddhist]",
);
console.log(dt1.equals(dt4)); // false

Проверка эквивалентности двух идентификаторов часовых поясов

function sameTimeZone(timeZone1, timeZone2) {
  const dt1 = Temporal.ZonedDateTime.from({
    year: 2021,
    month: 7,
    day: 1,
    timeZone: timeZone1,
  });
  const dt2 = Temporal.ZonedDateTime.from({
    year: 2021,
    month: 7,
    day: 1,
    timeZone: timeZone2,
  });
  return dt1.equals(dt2);
}

console.log(sameTimeZone("Asia/Kolkata", "Asia/Calcutta")); // true
console.log(sameTimeZone("Asia/Shanghai", "Asia/Taipei")); // false

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

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

См. также

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.compare()