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 数据类型的效率，但当所需值的范围超过 int 和 uint 数据类型的有效范围时，Number 数据类型很有用。Number 类可用于表示超出 int 和 uint 数据类型有效范围的整数值。Number 数据类型可使用多达 53 位来表示整数值，而 int 和 uint 则只能使用 32 位。Number 类型的变量的默认值为 NaN（非数字）。

查看示例

	属性	由以下参数定义
		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) 等效。

toExponential

()

方法

AS3 function toExponential(fractionDigits:uint):String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 9, AIR 1.0, Flash Lite 4

返回数字的字符串表示形式（采用指数表示法）。字符串在小数点前面包含一位，在小数点后面最多包含 20 位（在 fractionDigits 参数中指定）。

参数

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) 如何返回添加尾随 0 的字符串。


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 值。

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