Temporal.ZonedDateTime.prototype.valueOf()

Метод valueOf() экземпляров Temporal.ZonedDateTime вызывает TypeError, что предотвращает неявное преобразование в примитивы экземпляров Temporal.ZonedDateTime при использовании в арифметических операциях или операциях сравнения.

Синтаксис

valueOf()

Параметры

Нет.

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

Нет.

Исключения

TypeError

Вызывается всегда.

Описание

Поскольку и преобразование примитивов, и преобразование чисел вызывают valueOf() перед toString(), если valueOf() отсутствует, то выражение, подобное yearMonth1 > yearMonth2, неявно сравнило бы их как строки, что может привести к неожиданным результатам. Вызывая TypeError, экземпляры Temporal.ZonedDateTime предотвращают такие неявные преобразования. Вам необходимо явно преобразовать их в числа, используя Temporal.ZonedDateTime.prototype.epochNanoseconds, или использовать статический метод Temporal.ZonedDateTime.compare() для их сравнения.

Примеры

Арифметические операции и операции сравнения с Temporal.ZonedDateTime

Все арифметические операции и операции сравнения с экземплярами Temporal.ZonedDateTime должны использовать специализированные методы или явно преобразовывать их в примитивы.

const zdt1 = Temporal.ZonedDateTime.from(
  "2022-01-01T00:00:00[America/New_York]",
);
const zdt2 = Temporal.ZonedDateTime.from(
  "2022-07-01T00:00:00[America/New_York]",
);
zdt1 > zdt2; // TypeError: can't convert ZonedDateTime to primitive type
Temporal.ZonedDateTime.compare(zdt1, zdt2); // -1

zdt2 - zdt1; // TypeError: can't convert ZonedDateTime to primitive type
zdt2.since(zdt1).toString(); // "PT4343H"

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

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

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

• Temporal.ZonedDateTime
• Temporal.ZonedDateTime.prototype.toString()
• Temporal.ZonedDateTime.prototype.toJSON()
• Temporal.ZonedDateTime.prototype.toLocaleString()