valueOf (Object.valueOf メソッド)

指定されたオブジェクトのプリミティブな値を返します。オブジェクトにプリミティブな値がない場合、オブジェクトが返されます。

戻り値

Object - 指定したオブジェクトのプリミティブ値、またはオブジェクトそのもの。

例

次の例では、汎用オブジェクト (プリミティブな値を持たない) の valueOf() の戻り値を示し、toString() の戻り値と比較しています。最初に、汎用オブジェクトを作成します。次に、新しい Date オブジェクトを 2004 年 2 月 1 日午前 8 時 15 分に設定して作成します。toString() メソッドは、現在の時刻を人間が理解できる形式で返します。valueOf() メソッドは、プリミティブ値をミリ秒単位で返します。次に、2 つの単純なエレメントを含む新しい Array オブジェクトを作成します。toString() と valueOf() は同じ値 one,two を返します。

// 汎用オブジェクトを作成する
var myObject: Object = new Object();
trace(myObject.valueOf()); // [object Object] を出力する
trace(myObject.toString()); // [object Object] を出力する

次の例では、ビルトインクラス Date および Array の戻り値を示し、Object.toString() の戻り値と比較しています。

// 新しい Date オブジェクトを作成し、February 1, 2004, 8: 15 AM に設定する
// toString() メソッドは人間が理解できる形式で現在の時間を返す
// valueOf() メソッドは、プリミティブ値をミリ秒単位で返す
var myDate: Date = new Date(2004,01,01,8,15);
trace(myDate.toString()); // Sun Feb 1 08: 15: 00 GMT-0800 2004 を出力する
trace(myDate.valueOf()); // 1075652100000 を出力する

// 2 つの単純なエレメントを含む新しい Array オブジェクトを作成します。
// この場合、toString() と valueOf() は両方とも同じ値 one,two を返す
var myArray: Array = new Array("one", "two");
trace(myArray.toString()); // one,two を出力する
trace(myArray.valueOf()); // one,two を出力する

toString() を上書きするカスタムクラスの Object.valueOf() の戻り値の例については、Object.toString() を参照してください。

valueOf (Object.valueOf メソッド)

戻り値

例

関連項目