Number

Number 对象是经过封装的能让你处理数字值的对象。

实例方法

toFixed(fractionDigits?)

使用定点表示法来格式化一个数值。

参数

名称	类型	必填	描述
fractionDigits	number	否	小数点后数字的个数；介于 0 到 20（包括）之间，实现环境可能支持更大范围。如果忽略该参数，则默认为 0。

返回值

类型	描述
string	使用定点表示法表示给定数字的字符串。

function financial(x: Number): String {
  return x.toFixed(2);
}
console.log(financial(123.456));
// expected output: "123.46"
console.log(financial(0.004));
// expected output: "0.00"

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	4.0	√	√	√

toString()

返回指定 Number 对象的字符串表示形式。如果转换的基数大于 10，则会使用字母来表示大于 9 的数字，比如基数为 16 的情况，则使用 a 到 f 的字母来表示 10 到 15。如果基数没有指定，则使用 10。如果对象是负数，则会保留负号。即使 radix 是 2 时也是如此：返回的字符串包含一个负号（-）前缀和正数的二进制表示，不是 数值的二进制补码。进行数字到字符串的转换时，建议用小括号将要转换的目标括起来，防止出错。

参数

名称	类型	必填	描述
radix	number	否	指定要用于数字到字符串的转换的基数 (从 2 到 36)。如果未指定 radix 参数，则默认值为 10。

返回值

类型
string

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	4.0	√	√	√

valueOf()

返回一个被 Number 对象包装的原始值。

返回值

类型	描述
number	表示指定 Number 对象的原始值的数字。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	4.0	√	√	√

toInt()

返回一个Int 值

返回值

类型	描述
Int	返回 number 对应的 Int 值。

let a = 12
console.log(a.toInt());
// expected output: 12

// Int最大值2147483647,溢出了
let b = 2147483648
// expected output: -2147483648

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	x	√	√	x

toFloat()

返回一个Float 值

返回值

类型	描述
Float	返回 number 对应的 Float 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	x	√	√	x

toDouble()

返回一个 Double 值

返回值

类型	描述
Double	返回 number 对应的 Double 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	x	√	√	x

toUInt()

返回一个 UInt 值

返回值

类型	描述
UInt	返回 number 对应的 UInt 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	x	√	3.9+	x

toByte()

将当前的Number数据转换为Byte表示，如果超出Byte最大值表示范围，会得到溢出后余数表示, app-andorid平台特有。

返回值

类型	描述
Byte	返回 number 对应的 Byte 值。

let a = 12
console.log(a.toByte());
// expected output: 12

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	x	x	√	x	x

toLong()

将当前的Number数据转换为Long表示，如果超出Long最大值表示范围，会得到溢出后余数表示, app-andorid平台特有。

返回值

类型	描述
Long	返回 number 对应的 Long 值。

let a = 12
console.log(a.toLong());
// expected output: 12

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	x	x	√	x	x

toShort()

将当前的Number数据转换为Short表示，如果超出Short最大值表示范围，会得到溢出后余数表示, app-andorid平台特有。

返回值

类型	描述
Short	返回 number 对应的 Short 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	x	x	√	x	x

toUShort()

将当前的 Number 数据转换为 UShort 表示，如果超出 UShort 最大值表示范围，会得到溢出后余数表示, app-andorid平台特有。

返回值

类型	描述
UShort	返回 number 对应的 UShort 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	x	x	√	x	x

toULong()

将当前的 Number 数据转换为 ULong 表示，如果超出 ULong 最大值表示范围，会得到溢出后余数表示, app-andorid平台特有。

返回值

类型	描述
ULong	返回 number 对应的 ULong 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	x	x	√	x	x

toInt64()

返回一个 Int64 值, app-iOS平台特有。

返回值

类型	描述
Int64	返回 number 对应的 Int64 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toInt32()

返回一个 Int32 值, app-iOS平台特有。

返回值

类型	描述
Int32	返回 number 对应的 Int32 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toInt16()

返回一个 Int16 值, app-iOS平台特有。

返回值

类型	描述
Int16	返回 number 对应的 Int16 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toInt8()

返回一个 Int8 值, app-iOS平台特有。

返回值

类型	描述
Int8	返回 number 对应的 Int8 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toUInt64()

返回一个 UInt64 值, app-iOS平台特有。

返回值

类型	描述
UInt64	返回 number 对应的 UInt64 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toUInt32()

返回一个 UInt32 值, app-iOS平台特有。

返回值

类型	描述
UInt32	返回 number 对应的 UInt32 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toUInt16()

返回一个 UInt16 值, app-iOS平台特有。

返回值

类型	描述
UInt16	返回 number 对应的 UInt16 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

toUInt8()

返回一个 UInt8 值, app-iOS平台特有。

返回值

类型	描述
UInt8	返回 number 对应的 UInt8 值。

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
x	4.11	x	x	3.9+	x

静态方法

from()

通过 Int | Float | Double | Int64 | Int32 | Int16 | Int8 | UInt | UInt64 | UInt32 | UInt16 | UInt8 | Byte | Short | Long 类型创建一个 number

参数

名称	类型	必填	描述
value	Int | Float | Double | Int64 | Int32 | Int16 | Int8 | UInt | UInt64 | UInt32 | UInt16 | UInt8 | Byte | Short | Long	是	必填。一个 Swfit 或者 Kottlin 专有数字类型的值。其中 Swift 平台 支持 Int, Float, Double, Int64, Int32, Int16, Int8, UInt, UInt64, UInt32, UInt16, UInt8。Kottlin 平台支持 Int, Float, Double, Byte, Short, Long

返回值

类型	描述
number	返回 number

兼容性

Android uni-app x	iOS uni-app x	web uni-app x	Android uni-app	iOS uni-app	web uni-app
3.9	4.11	x	3.9+	3.9+	x

let a: Int = 12
let b = Number.from(a)
console.log(b);
// expected output: 12

参见

相关 Bug