[@@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 の定義
ドラフト  

ブラウザの実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeEdge MobileAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
基本対応Chrome ? Edge ? Firefox 完全対応 44IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android 完全対応 44Opera Android ? Safari iOS ? Samsung Internet Android ? nodejs 完全対応 6.0.0

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明

関連情報

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

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