【JavaScript ECMAScript】Date::Date.prototype[Symbol.toPrimitive]インスタンスメソッドの使い方

Date.prototypeSymbol.toPrimitiveメソッドは、Dateオブジェクトが数値や文字列といったプリミティブな値に変換される際の動作を制御するメソッドです。JavaScriptでは、オブジェクトを数値演算や文字列連結、比較などの操作で利用する際、内部的にそのオブジェクトをプリミティブ値に変換しようとします。この変換処理をカスタマイズするために、[Symbol.toPrimitive]という特殊なシンボルプロパティが使用されます。

DateオブジェクトのSymbol.toPrimitiveメソッドは、この変換ロジックを実装しています。このメソッドはhintという引数を受け取ります。hintは、変換されるプリミティブ値の型が「"number"（数値）」「"string"（文字列）」「"default"（既定）」のいずれであるかを指示する文字列です。

具体的には、hintが"string"または"default"の場合、このメソッドは通常、Dateオブジェクトが表す日付と時刻を人間が読める形式の文字列として返します。これは、日付を文字列と連結する際などに使われます。一方、hintが"number"の場合、メソッドはDateオブジェクトが表す時刻を、1970年1月1日0時0分0秒UTCからの経過ミリ秒数として数値で返します。これは、日付の比較や数値計算を行う際などに利用されます。

このように、Date.prototypeSymbol.toPrimitiveメソッドは、文脈に応じてDateオブジェクトが自動的に適切なプリミティブ値へと変換されるメカニズムを提供します。これにより、システムエンジニアを目指す初心者は、Dateオブジェクトをより直感的に扱い、明示的な型変換の記述を減らすことができます。

Copy
1const dateObj = new Date();
2const primitiveValue = dateObj[Symbol.toPrimitive]('string'); // 引数には 'string', 'number', 'default' のいずれかを指定

hint

• hint: string: 実行される文字列変換のヒント。"default"、"string"、"number" のいずれか。

String | Number

Dateオブジェクトのプリミティブな値（文字列または数値）を返します。