Number

Paquete	Nivel superior
Clase	public final class Number
Herencia	Number Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Un tipo de datos que representa un número IEEE-754 de coma flotante de doble precisión. Puede manipular valores numéricos simples utilizando los métodos y propiedades asociados a la clase Number. Esta clase es idéntica a la clase Number de JavaScript.

Las propiedades de la clase Number son estáticas, lo que significa que no necesita un objeto para utilizarlas, por lo que no es preciso que utilice el constructor.

El tipo de datos Number cumple la norma de doble precisión IEEE-754.

El tipo de datos Number resulta útil si necesita utilizar valores de coma flotante. Los motores de ejecución de Flash gestionan los tipos de datos int y uint de manera más eficiente que Number, pero Number es útil en situaciones en las que el rango de valores requerido supera el rango válido de los tipos de datos int y uint. La clase Number puede utilizarse para representar valores enteros muy superiores o inferiores a los del rango válido de los tipos de datos int y uint. El tipo de datos Number puede utilizar hasta 53 bits para representar valores de enteros, mientras que int y uint disponen de 32 bits. El valor predeterminado de una variable que tiene asignado el tipo Number es NaN (no es un número).

Ver los ejemplos

Elementos de API relacionados

int
uint

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		Number(num:Object) Crea un objeto Number con el valor especificado.	Number
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toExponential(fractionDigits:uint):String Devuelve una representación de cadena del número en notación exponencial.	Number
		toFixed(fractionDigits:uint):String Devuelve una representación de cadena del número en notación de coma fija.	Number
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toPrecision(precision:uint):String Devuelve una representación de cadena del número en notación exponencial o en notación de coma fija.	Number
		toString(radix:Number = 10):String Devuelve la representación de cadena del objeto Number especificado (myNumber).	Number
		valueOf():Number Devuelve el tipo de valor simple del objeto Number especificado.	Number

Constantes públicas

	Constante		Definido por
		MAX_VALUE : Number [estática] El número más grande que puede representarse (doble precisión IEEE-754).	Number
		MIN_VALUE : Number [estática] El número representable IEEE-754 más pequeño (el más cercano a cero, no el más negativo) que no se compara es igual a cero.	Number
		NaN : Number [estática] El valor IEEE-754 que representa a Not a Number (NaN, no es un número).	Number
		NEGATIVE_INFINITY : Number [estática] Especifica el valor IEEE-754 que representa el infinito negativo.	Number
		POSITIVE_INFINITY : Number [estática] Especifica el valor IEEE-754 que representa el infinito positivo.	Number

Información sobre constructores

()

Información sobre

public function Number(num:Object)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un objeto Number con el valor especificado. Este constructor tiene el mismo efecto que la función nativa pública Number() que convierte un objeto de un tipo diferente en un valor numérico simple.

Parámetros

num:Object — El valor numérico de la instancia Number que se crea o un valor que se va a convertir en un valor Number. Si no se especifica num, el valor predeterminado es 0. El uso del constructor sin especificar un parámetro num no es lo mismo que declarar una variable de tipo Number sin valor asignado (como, por ejemplo, var myNumber:Number), que adopta de manera predeterminada el valor NaN. Un número sin valor asignado es un valor undefined y equivale a new Number(undefined).

Elementos de API relacionados

Number.toString()
Number.valueOf()

Información sobre métodos

toExponential

()

método

AS3 function toExponential(fractionDigits:uint):String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve una representación de cadena del número en notación exponencial. La cadena contiene un dígito antes de la coma decimal y hasta 20 dígitos después de la coma decimal, conforme a lo especificado por el parámetro fractionDigits.

Parámetros

fractionDigits:uint — Un entero entre 0 y 20, ambos inclusive, que representa el número deseado de cifras decimales.

Valor devuelto

String

Emite

RangeError — Emite una excepción si el argumento fractionDigits queda fuera del rango de 0 a 20.

Ejemplo ( Cómo utilizar este ejemplo )

El siguiente ejemplo ilustra cómo toExponential(2) devuelve una cadena en notación exponencial.

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

toFixed

()

método

AS3 function toFixed(fractionDigits:uint):String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve una representación de cadena del número en notación de coma fija. La notación de coma fija significa que la cadena contendrá un número concreto de dígitos tras la coma decimal, conforme a lo especificado en el parámetro fractionDigits. El rango válido para el parámetro fractionDigits va de 0 a 20. Al especificar un valor situado fuera de este rango, se emite una excepción.

Parámetros

fractionDigits:uint — Un entero entre 0 y 20, ambos inclusive, que representa el número deseado de cifras decimales.

Valor devuelto

String

Emite

RangeError — Emite una excepción si el argumento fractionDigits queda fuera del rango de 0 a 20.

Ejemplo ( Cómo utilizar este ejemplo )

El siguiente ejemplo ilustra cómo toFixed(3) devuelve una cadena que se redondea hasta tres decimales.

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

El siguiente ejemplo ilustra cómo toFixed(2) devuelve una cadena que añade ceros finales.

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

toPrecision

()

método

AS3 function toPrecision(precision:uint):String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Lite 4

Devuelve una representación de cadena del número en notación exponencial o en notación de coma fija. La cadena contendrá el número de dígitos especificado en el parámetro precision.

Parámetros

precision:uint — Un entero entre 1 y 21, ambos inclusive, que representa el número deseado de dígitos para representar la cadena resultante.

Valor devuelto

String

Emite

RangeError — Emite una excepción si el argumento precision queda fuera del rango de 1 a 21.

Ejemplo ( Cómo utilizar este ejemplo )

El siguiente ejemplo ilustra cómo toPrecision(3) devuelve una cadena con sólo tres dígitos. La cadena se expresa en notación de coma fija, ya que no se requiere notación exponencial.

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

El siguiente ejemplo ilustra cómo toPrecision(3) devuelve una cadena con sólo tres dígitos. La cadena se expresa en notación exponencial, ya que el número resultante no contiene dígitos suficientes para la notación de coma fija.

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

toString

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve la representación de cadena del objeto Number especificado (myNumber). Si el valor del objeto Number es un número decimal sin un cero a la izquierda (como, por ejemplo, 0,4), Number.toString() añade un cero a la izquierda (0,4).

Parámetros

radix:Number (default = 10) — Especifica la base numérica (de 2 a 36) que debe utilizarse en la conversión de número a cadena. Si no especifica el parámetro radix, el valor predeterminado es 10.

Valor devuelto

String — Representación numérica del objeto Number como una cadena.

valueOf

()

método

AS3 function valueOf():Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve el tipo de valor simple del objeto Number especificado.

Valor devuelto

Number — El valor de tipo simple del objeto Number.

Información sobre constantes

MAX_VALUE

Constante

public static const MAX_VALUE:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

El número más grande que puede representarse (doble precisión IEEE-754). Este número es aproximadamente 1.79e+308.

MIN_VALUE

Constante

public static const MIN_VALUE:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

El número representable IEEE-754 más pequeño (el más cercano a cero, no el más negativo) que no se compara es igual a cero. En la mayoría de las plataformas, este número es aproximadamente 5e-324, pero puede ser mayor en los sistemas que no admiten números desnormalizados. Por ejemplo, en iOS el valor de esta constante es 2.225e-308.

Nota: el número absoluto total más pequeño que puede representarse es -Number.MAX_VALUE.

NaN

Constante

public static const NaN:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

El valor IEEE-754 que representa a Not a Number (NaN, no es un número).

Elementos de API relacionados

Función global isNaN()

NEGATIVE_INFINITY

Constante

public static const NEGATIVE_INFINITY:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Especifica el valor IEEE-754 que representa el infinito negativo. El valor de esta propiedad es el mismo que el de la constante -Infinity.

Infinito negativo es un valor numérico especial que se devuelve cuando una operación o función matemática devuelve un valor negativo mayor de lo que es posible representar.

POSITIVE_INFINITY

Constante

public static const POSITIVE_INFINITY:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Especifica el valor IEEE-754 que representa el infinito positivo. El valor de esta propiedad es el mismo que el de la constante Infinity.

Infinito positivo es un valor numérico especial que se devuelve cuando una operación o función matemática devuelve un valor positivo mayor de lo que es posible representar.

Ejemplos Cómo utilizar este ejemplo

NumberExample.as

El siguiente ejemplo ilustra cómo un número con seis dígitos después de la posición decimal se trunca (con redondeo) para obtener un número con dos dígitos después del punto decimal.

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
        }
    }
}

Avisos legales | Política de privacidad en línea

Number - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Clases x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY