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 (ECMA-262)
Date.prototype.@@toPrimitive の定義
現行の標準  

ブラウザの実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
@@toPrimitiveChrome 完全対応 47Edge 完全対応 15Firefox 完全対応 44IE 未対応 なしOpera 完全対応 34Safari 完全対応 10WebView Android 完全対応 47Chrome Android 完全対応 47Firefox Android 完全対応 44Opera Android 完全対応 34Safari iOS 完全対応 10Samsung Internet Android 完全対応 5.0nodejs 完全対応 6.0.0

凡例

完全対応  
完全対応
未対応  
未対応

関連情報