Number

套件	最上層
類別	public final class Number
繼承	Number Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表 IEEE-754 雙精度浮點數的資料類型。您可以使用與這個 Number 類別相關的方法和屬性來操作基本數值。這個類別與 JavaScript 的 Number 類別相同。

然而，Number 類別的屬性是靜態的，也就是說您不需要物件即可使用它們，因此您也不需要用到建構函式。

Number 資料類型會遵循雙精度 IEEE-754 標準。

當您需要使用浮點值時，Number 資料類型便會相當有用。 Flash 執行階段對 int 與 uint 資料類型的處理比對 Number 更有效率，但是 Number 在所需值範圍超過 int 與 uint 資料類型的有效範圍時，便會更為有用。Number 類別可以用來表示超過 int 與 uint 資料類型之有效範圍的整數值。 Number 資料類型可使用多達 53 位元以表示整數值，相較之下，int 與 uint 則只能使用 32 位元。類型為 Number 之變數的預設值為 NaN (不是 Number)。

相關 API 元素

公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Number(num:Object) 會建立具有指定值的 Number 物件。	Number
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toExponential(fractionDigits:uint):String 使用指數標記法傳回數字的字串形式。	Number
		toFixed(fractionDigits:uint):String 會使用定點標記法傳回數字的字串形式。	Number
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toPrecision(precision:uint):String 會使用指數標記法或定點標記法，傳回數字的字串形式。	Number
		toString(radix:Number = 10):String 傳回指定 Number 物件 (myNumber) 的字串形式。	Number
		valueOf():Number 傳回指定之 Number 物件的基本值類型。	Number

公用常數

	常數		定義自
		MAX_VALUE : Number [靜態] 最大的可表示數字 (雙精度 IEEE-754)。	Number
		MIN_VALUE : Number [靜態] 最小 (最接近零但並非最接近負數) 的可表示 IEEE-754 數字 (不等於零)。	Number
		NaN : Number [靜態] 代表「非數字」(NaN) 的 IEEE-754 值。	Number
		NEGATIVE_INFINITY : Number [靜態] 指定代表負無限大的 IEEE-754 值。	Number
		POSITIVE_INFINITY : Number [靜態] 指定代表正無限大的 IEEE-754 值。	Number

建構函式詳細資料

()

建構函式

public function Number(num:Object)

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會建立具有指定值的 Number 物件。此建構函式與 Number() 公用原生函數具有相同效果，該函數會將不同類型的物件轉換成基本數值。

參數

num:Object — 所建立之 Number 實體的數值，或是要轉換成 Number 的值。如果沒有指定 num，則預設值為 0。使用建構函式而不指定 num 參數，與宣告 Number 類型的變數而不指派值 (如 var myNumber:Number) 不同，其預設值會是 NaN。定義了未指定任何值的數字，而且會與 new Number(undefined) 相等。

相關 API 元素

Number.toString()
Number.valueOf()

方法詳細資訊

toExponential

()

方法

AS3 function toExponential(fractionDigits:uint):String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 9, AIR 1.0, Flash Lite 4

使用指數標記法傳回數字的字串形式。所謂指數標記法，就是字串會依照 fractionDigits 參數的指定方式，只在小數點前包含一位數，而在小數點後最多可包含 20 位數。

參數

fractionDigits:uint — 介於 0 到 20 之間的整數 (含上下限)，代表所需的小數位數。

傳回值

String

擲回值

RangeError — 如果 fractionDigits 引數在 0 到 20 的範圍外，則會擲回例外。

範例 ( 如何使用本範例 )

下列範例會示範 toExponential(2) 如何在指數標記法中傳回字串。


var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()

方法

AS3 function toFixed(fractionDigits:uint):String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 9, AIR 1.0, Flash Lite 4

會使用定點標記法傳回數字的字串形式。所謂定點標記法，就是字串會依照 fractionDigits 參數中的指定方式，在小數點後包含特定數目的位數。 fractionDigits 參數有效的範圍是從 0 到 20。指定這個範圍以外的值會擲回例外。

參數

fractionDigits:uint — 介於 0 到 20 之間的整數 (含上下限)，代表所需的小數位數。

傳回值

String

擲回值

RangeError — 如果 fractionDigits 引數在 0 到 20 的範圍外，則會擲回例外。

範例 ( 如何使用本範例 )

下列範例會示範 toFixed(3) 如何傳回四捨五入為三位小數的字串。


var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

下列範例會示範 toFixed(2) 如何傳回會加入結尾零的字串。


var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()

方法

AS3 function toPrecision(precision:uint):String

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 9, AIR 1.0, Flash Lite 4

會使用指數標記法或定點標記法，傳回數字的字串形式。此字串將會包含 precision 參數中指定的位數。

參數

precision:uint — 介於 1 與 21 之間的整數 (含上下限)，代表產生的字串中所需的位數。

傳回值

String

擲回值

RangeError — 如果 precision 引數在 1 到 21 的範圍外，則會擲回例外。

範例 ( 如何使用本範例 )

下列範例會示範 toPrecision(3) 如何傳回只有三位數的字串。此字串會使用定點標記法，因為在此並不需要指數標記法。


var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

下列範例會示範 toPrecision(3) 如何傳回只有三位數的字串。此字串是使用指數標記法，因為產生的數字未包含定點標記法所需的足夠位數。


var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()

方法

AS3 function toString(radix:Number = 10):String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回指定之 Number 物件 (myNumber) 的字串形式。如果 Number 物件的值是開頭不是零的十進位數字 (如 .4)，Number.toString() 便會加入開頭的零 (0.4)。

參數

radix:Number (default = 10) — 會指定用於數字到字串轉換的底數 (從 2 到 36)。如果您並未指定 radix 參數，預設值會是 10。

傳回值

String — 做為字串之 Number 物件的數字形式。

valueOf

()

方法

AS3 function valueOf():Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

傳回指定之 Number 物件的基本值類型。

傳回值

Number — Number 物件的基本類型值。

常數詳細資訊

MAX_VALUE

常數

public static const MAX_VALUE:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

最大的可表示數字 (雙精度 IEEE-754)。這個數字接近 1.79e+308。

MIN_VALUE

常數

public static const MIN_VALUE:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

最小 (最接近零但並非最接近負數) 的可表示 IEEE-754 數字 (不等於零)。在大多數的平台上，這個數字接近 5e-324，但在不支援還原標準化的數字的系統上會比較大。例如，在 iOS 上，這個常數值為 2.225e-308。

注意：整體「絕對」最小的可表示數字為 -Number.MAX_VALUE。

NaN

常數

public static const NaN:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表「非數字」(NaN) 的 IEEE-754 值。

相關 API 元素

isNaN() 全域函數

NEGATIVE_INFINITY

常數

public static const NEGATIVE_INFINITY:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

指定代表負無限大的 IEEE-754 值。這個屬性的值和常數 -Infinity 的值相同。

負無限大是一個特殊的數值，會在數學運算或函數傳回的負值大於可顯示的值時被傳回。

POSITIVE_INFINITY

常數

public static const POSITIVE_INFINITY:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

指定代表正無限大的 IEEE-754 值。這個屬性的值和常數 Infinity 的值相同。

正無限大是一個特殊的數值，會在數學運算或函數傳回的值大於可顯示的值時被傳回。

範例如何使用本範例

NumberExample.as

下列範例會說明小數位數之後含有六位數的數字如何 (以四捨五入的方式) 截斷成小數點之後含有兩位數的數字。


package {
    import flash.display.Sprite;

    public class NumberExample extends Sprite {
        public function NumberExample() {
            var num:Number = new Number(10.456345);
            var str:String = num.toFixed(2);
            trace(num); // 10.456345
            trace(str); // 10.46
        }
    }
}

法律聲明 | 線上隱私權政策

Number - AS3

類別 x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY