We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Date.prototype[@@toPrimitive]

[@@toPrimitive]() メソッドは、Date オブジェクトをプリミティブ値に変換します。

構文

Date()[Symbol.toPrimitive](hint);

戻り値

与えられた Date オブジェクトのプリミティブ値。引数に応じて、このメソッドは文字列と数値のどちらかを返します。

説明

Date オブジェクトの [@@toPrimitive]() メソッドは、プリミティブ値を返します。これは、数値型か文字列型です。

hint"string" または "default" の場合、[@@toPrimitive]()toString メソッドを呼び出そうとします。toString メソッドが存在しなければ、valueOf メソッドを呼び出そうとします。valueOf メソッドも存在しなければ、[@@toPrimitive]()TypeError を投げます。

hint"number" の場合、[@@toPrimitive]() は初めに valueOf メソッドを呼び出そうとします。これが失敗した場合は、toString メソッドを呼び出します。

JavaScript は、[@@toPrimitive]() メソッドを呼び出してオブジェクトをプリミティブ値に変換します。[@@toPrimitive]() メソッドを自分で呼び出す必要はほとんどありません。JavaScript は、プリミティブ値が期待されるオブジェクトに遭遇した時、自動的にこれを呼び出します。

仕様

仕様書 策定状況 備考
ECMAScript 2015 (6th Edition, ECMA-262)
Date.prototype.@@toPrimitive の定義
標準 初期定義。
ECMAScript Latest Draft (ECMA-262)
Date.prototype.@@toPrimitive の定義
ドラフト

ブラウザの実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート ? 44.0 (44.0) ? ? ?
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? ? 44.0 (44.0) ? ? ?

関連情報

ドキュメントのタグと貢献者

このページの貢献者: Marsf, YuichiNukiyama
最終更新者: Marsf,