Skip to content

函数: formatBytes()

ts
function formatBytes(bytes, decimals?): string;

定义于: file.ts:83

将字节数格式化为带单位的可读大小。

以 1024 为进制自动选择单位(BKBMBGBTBPB),超出最大单位时统一按 PB 计。

参数

参数类型默认值描述
bytesnumberundefined字节数,需为非负数值。
decimalsnumber2保留的小数位数,默认 2(尾部多余的零会被去除,如 1.50 显示为 1.5)。

返回值

string

形如 '1.5KB' 的字符串;bytes 为非数值、NaN 或负数时返回 ''

示例

ts
formatBytes(0)          // => '0B'
formatBytes(1536)       // => '1.5KB'
formatBytes(1234567)    // => '1.18MB'
formatBytes(1536, 0)    // => '2KB'(指定小数位)
formatBytes(-1)         // => ''(负数)