MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

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 2017 Draft (ECMA-262)
Date.prototype.@@toPrimitive の定義
ドラフト

ブラウザの実装状況

機能 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,