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 は、プリミティブ値が期待されるオブジェクトに遭遇した時、自動的にこれを呼び出します。

仕様

ブラウザの実装状況

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

関連情報

• Symbol.toPrimitive