Temporal.Instant.prototype.valueOf()

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

Синтаксис

valueOf()

Параметры

Нет.

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

Нет.

Исключения

TypeError

Всегда выбрасывается.

Описание

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

Примеры

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

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

const instant1 = Temporal.Instant.fromEpochMilliseconds(0);
const instant2 = Temporal.Instant.fromEpochMilliseconds(1000);
instant1 > instant2; // TypeError: can't convert Instant to primitive type
instant1.epochNanoseconds > instant2.epochNanoseconds; // false
Temporal.Instant.compare(instant1, instant2); // -1

instant2 - instant1; // TypeError: can't convert Instant to primitive type
instant2.since(instant1).toString(); // "PT1S"

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

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

См. также

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