Temporal.PlainYearMonth.prototype.valueOf()

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

Синтаксис

valueOf()

Параметры

Нет.

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

Нет.

Исключения

TypeError

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

Описание

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

Примеры

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

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

const ym1 = Temporal.PlainYearMonth.from("2021-01");
const ym2 = Temporal.PlainYearMonth.from("2021-07");
ym1 > ym2; // TypeError: can't convert PlainYearMonth to primitive type
Temporal.PlainYearMonth.compare(ym1, ym2); // -1

ym2 - ym1; // TypeError: can't convert PlainYearMonth to primitive type
ym2.since(ym1).toString(); // "P6M"

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

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

Смотри также

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