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

Temporal.Instant.prototype.valueOf()メソッドは、Temporal.Instantオブジェクトのプリミティブな表現を取得するために使用されるメソッドです。

Temporal.Instantは、タイムゾーンやカレンダー情報に依存せず、特定の正確な時点（例えば、Unixエポックからのナノ秒数）を表すためのJavaScriptの新しい日付・時刻APIのオブジェクトです。このオブジェクトは、時間の絶対的な瞬間を扱います。

JavaScriptの多くのオブジェクトには、valueOf()メソッドが標準で備わっており、これはオブジェクトがプリミティブ値（数値や文字列など）に変換される必要がある際に内部的に呼び出されます。しかし、Temporal.InstantのvalueOf()メソッドは、そのインスタンス自身の参照を返します。これは、Temporal.Instantがプリミティブ値に直接変換されることを意図しておらず、そのオブジェクト自体が表現する意味の核であるという設計思想に基づいています。

そのため、開発者がこのメソッドを直接呼び出して数値などのプリミティブ値を得る用途で使うことは一般的ではありません。主にJavaScriptエンジンが、オブジェクトの比較など特定の文脈で内部的に利用することが想定されています。Temporal APIは、日付と時刻の複雑な処理をより堅牢かつ直感的に行うために導入されたもので、このvalueOf()メソッドもその全体的な設計の一部をなしています。

Copy
1const instant = Temporal.Instant.from('2023-10-26T10:00:00Z');
2instant.valueOf();

引数なし

引数はありません

Temporal.Instant

Temporal.Instant.prototype.valueOf() は、メソッドが呼び出された Temporal.Instant オブジェクト自体を返します。