【JavaScript ECMAScript】Temporal::Temporal.PlainDate.prototype.valueOfインスタンスメソッドの使い方

Temporal.PlainDate.prototype.valueOf()メソッドは、Temporal.PlainDateオブジェクトのプリミティブ値を取得しようとするとTypeErrorを実行するメソッドです。JavaScriptにおいて、多くのオブジェクトはvalueOf()メソッドを持っており、これはオブジェクトのプリミティブ表現を返すために使用されます。しかし、ECMAScriptのTemporal APIの設計思想では、日付や時刻といった複雑な概念を持つTemporalオブジェクトは、通常の数値や文字列のような単純なプリミティブ値に自動的に変換されるべきではないとされています。

このため、Temporal.PlainDateインスタンスに対してvalueOf()メソッドが呼び出されると、明示的にTypeErrorがスローされます。これは、例えば、Temporal.PlainDateオブジェクトを数値と比較演算子（<、>、<=、>=など）を使って直接比較しようとした場合など、JavaScriptエンジンが暗黙的にオブジェクトのプリミティブ値への変換を試みる際に発生します。

Temporal.PlainDateオブジェクトの値を比較したい場合は、valueOf()メソッドの代わりに、専用の比較メソッドであるequals()またはcompare()を使用することが推奨されます。これにより、意図しない型変換によるエラーを防ぎ、日付の比較をより安全かつ正確に行うことができます。この設計は、Temporal APIが提供する正確な日付と時刻の取り扱いを保証するための一環です。

Copy
1const plainDate = Temporal.PlainDate.from({ year: 2023, month: 10, day: 26 });
2const value = plainDate.valueOf();

引数なし

引数はありません

Temporal.PlainDate

このメソッドは、Temporal.PlainDate オブジェクトの内部表現を表す値を返します。