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

Temporal.ZonedDateTime.prototype.valueOf()メソッドは、Temporal.ZonedDateTimeインスタンスのプリミティブな値を取得しようとするときに呼び出されるメソッドです。JavaScriptでは通常、valueOf()メソッドはオブジェクトを数値や文字列といった基本的なデータ型（プリミティブな値）に変換するために使われ、特に算術演算や比較などの際に暗黙的に呼び出されることがあります。

しかし、Temporal.ZonedDateTime.prototype.valueOf()メソッドは、このような標準的な振る舞いとは異なり、呼び出されると常にTypeErrorをスローします。これは、Temporal.ZonedDateTimeオブジェクトが日付、時刻、および特定のタイムゾーンに関する複雑な情報を保持しており、これらを単一の単純なプリミティブな値に変換することが意味をなさない、あるいは情報が失われる可能性があるためです。

Temporal APIは、開発者が意図しない暗黙的な型変換によって予期せぬエラーやバグが発生するのを防ぐために、この設計を採用しています。Temporal.ZonedDateTimeオブジェクトの値を比較したり、特定の形式で表現したりする必要がある場合は、代わりにepochMillisecondsプロパティを使ってエポックからのミリ秒数として取得したり、toString()メソッドで文字列表現を得たり、toJSON()メソッドでJSON形式の文字列として取得するなど、目的に応じた明示的なメソッドを使用することが推奨されます。この設計は、時間情報の正確性と一貫性を保つための重要な特徴です。

Copy
1const someZonedDateTime = new Temporal.ZonedDateTime(
2  0n,
3  'UTC',
4  Temporal.Calendar.from('iso8601')
5);
6const value = someZonedDateTime.valueOf();

引数なし

引数はありません

戻り値なし

戻り値はありません