数字（Number）

生成各种数字的模块。

概述

对于简单的整数，请使用 {{$number.int}}。对于十进制/浮点数，请使用 {{$number.float}}。

对于非 10 进制的数字，可以使用 {{$number.hex}}、{{$number.octal}} 和 {{$number.binary}}。

相关模块

对于给定长度的数字字符串，请使用 {{$string.numeric}}。 对于信用卡号，请使用 {{$finance.creditCardNumber}}。

bigInt

返回一个 BigInt 数字。边界值包含在内。

参数

名称	类型	默认值	描述
max	字符串 | 数字 | bigint |	min + 999999999999999n	生成的 bigint 的上限。
min	字符串 | 数字 | bigint |	0n	生成的 bigint 的下限。

返回: bigint

示例

{{$number.bigInt}}  // '658577825017810'

{{$number.bigInt(min='1000000')}}  // '393309651182825'

{{$number.bigInt(max='100')}}  // '24'

{{$number.bigInt(min='10',max='100')}}  // '34'

binary

返回一个 二进制 数字。边界值包含在内。

参数

名称	类型	默认值	描述
max	字符串 | 数字 | bigint |	1	生成的数字的上限。
min	字符串 | 数字 | bigint |	0	生成的数字的下限。

返回: 字符串

示例

{{$number.binary}}  // '1'

{{$number.binary(min=0,max=65535)}} // '100101100011000'

float

返回一个随机的浮点数，默认情况下介于 0.0 和 1.0 之间。要更改范围，请传递 min 和 max 值。要限制小数位数，请传递 multipleOf 或 fractionDigits 参数。

参数

名称	类型	默认值	描述
fractionDigits	数字		小数点后出现的最大位数，例如 2 将舍入到 2 位小数。multipleOf 或 fractionDigits 只能传递一个。
max	数字	1.0	生成的数字的上限，不包括在内，除非传递了 multipleOf 或 fractionDigits。
max	数字	0.0	生成的数字的下限，包括在内。
multipleOf	数字		生成的数字将是此参数的倍数。multipleOf 或 fractionDigits 只能传递一个。

返回: 数字

示例

{{$number.float}}  // '0.6293353106763337'

{{$number.float(max=100)}}  // '61.583601816789745'

{{$number.float(min=20,max=100)}}  // '88.93489807538822'

{{$number.float(min=20,max=100,multipleOf=0.25)}}  // '25'

{{$number.float(min=20,max=100,fractionDigits=3)}}  // '83.294'

hex

返回一个 十六进制 数字（小写）。边界值包含在内。

参数

名称	类型	默认值	描述
max	数字	15	生成的数字的上限
max	数字	0	生成的数字的下限

返回: 字符串

示例

{{$number.hex}}  // 'e'

{{$number.hex(min=0,max=65535)}}  // '90ff'

int

返回一个介于零和给定最大值或给定范围之间的随机整数。边界值包含在内。

参数

名称	类型	默认值	描述
max	数字	Number.MAX_SAFE_INTEGER	生成的数字的上限
max	数字	0	生成的数字的下限
multipleOf	数字	1	生成的数字将是给定整数的倍数。

返回: 数字

示例

{{$number.int}}  // '3014636528100856'

{{$number.int(min=1000000)}}  // '613071964516055'

{{$number.int(max=100)}}  // '46'

{{$number.int(min=10,max=100)}}  // '37'

{{$number.int(min=10,max=100,multipleOf=10)}}  // '50'

octal

返回一个 八进制 数字。边界值包含在内。

参数

名称	类型	默认值	描述
max	数字	7	生成的数字的上限
max	数字	0	生成的数字的下限

返回: 字符串

示例

{{$number.octal}} // '4'

{{$number.octal(min=0,max=65535)}}  // '144567'