Temporal.PlainYearMonth.prototype.valueOf()

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

valueOf() 方法，針對 Temporal.PlainYearMonth 例項，會丟擲一個 TypeError。這可以防止 Temporal.PlainYearMonth 例項在算術或比較操作中被隱式轉換為原始型別。

由於原始型別轉換和數字轉換都會在呼叫 toString() 之前呼叫 valueOf()，如果 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"