public valueOf() : Object

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

戻り値

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 オブジェクトを 2004 年 2 月 1 日午前 8 時 15 分に設定して作成します
// 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() の例を参照してください。

関連項目

toString (Object.toString メソッド)