Temporal.PlainTime.prototype.valueOf()

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

Синтаксис

valueOf()

Параметры

Нет.

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

Нет.

Исключения

TypeError

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

Описание

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

Примеры

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

Для всех арифметических операций и операций сравнения с экземплярами Temporal.PlainTime следует использовать специальные методы или явно преобразовывать их в примитивы.

const time1 = Temporal.PlainTime.from("00:00:00");
const time2 = Temporal.PlainTime.from("12:00:00");
time1 > time2; // TypeError: can't convert PlainTime to primitive type
Temporal.PlainTime.compare(time1, time2); // -1

time2 - time1; // TypeError: can't convert PlainTime to primitive type
time2.since(time1).toString(); // "PT12H"

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

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

См. также

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