[@@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) | ? | ? | ? |