pretty-bytes

将字节转换为人类可读的字符串:’ 1337 ‘→’ 1.34 kB ‘

用于显示人类可读的文件大小

留神，它应用 base-10(例如，kilobyte)。理解 kilobyte 和 kibibyte 之间的差别

装置

$ npm install pretty-bytes

应用

const prettyBytes = require('pretty-bytes');

prettyBytes(1337);
//=> '1.34 kB'

prettyBytes(100);
//=> '100 B'

// 以 bits 为单位的显示
prettyBytes(1337, {bits: true});
//=> '1.34 kbit'

// 显示文件大小差别
prettyBytes(42, {signed: true});
//=> '+42 B'

// Localized output using German locale
prettyBytes(1337, {locale: 'de'});
//=> '1,34 kB'

API

prettyBytes(number, options?)

number

Type: number

要格式化的数字

options

Type: object

signed

Type: boolean
Default: false

负数蕴含 + 号，如果差值恰好为零，则将应用空格字符代替，以更好地对齐。

bits

Type: boolean
Default: false

将数字格局设置为 bits 而不是 bytes. 在以下状况下，这可能会很有用：例如，对于 bit rate.

binary

Type: boolean
Default: false

应用二进制前缀而不是 SI 前缀格式化数字。
这对于显示存储量可能很有用。然而，不应将其用于显示文件大小。

locale

Type: boolean | string
Default: false (没有本地化)

重要提醒：仅数字和小数点分隔符已本地化。单元题目不是，也不会本地化。

• 如果 true: 应用零碎 / 浏览器区域设置本地化输入。
• 如果 string: 须要 BCP 47 语言标签（例如：en，de等）
• 如果 string[]: 须要 BCP 47 语言标签的列表（例如：”en”，”de” 等）

留神：本地化通常应在浏览器中进行。Node.js 须要应用 ”full-icu” 或 ”system-icu” 来构建. 或者，能够应用 full-icu 模块在运行时提供反对。Node.js 13 和更高版本默认状况下都附带 ICU。

minimumFractionDigits

Type: number
Default: undefined

显示的最小小数位数。

如果未设置 ”minimumFractionDigits” 或 ”maximumFractionDigits”，则默认行为是四舍五入到 3 个有效数字。

const prettyBytes = require('pretty-bytes');

// 显示至多蕴含 3 个小数位的数字
prettyBytes(1900, {minimumFractionDigits: 3});
//=> '1.900 kB'

prettyBytes(1900);
//=> '1.9 kB'

maximumFractionDigits

Type: number
Default: undefined

要显示的最大小数位数。

如果未设置 ”minimumFractionDigits” 或 ”maximumFractionDigits”，则默认行为是四舍五入到 3 个有效数字。

const prettyBytes = require('pretty-bytes');

// 显示最多 1 个小数位数的数字
prettyBytes(1920, {maximumFractionDigits: 1});
//=> '1.9 kB'

prettyBytes(1920);
//=> '1.92 kB'

相干模块

• pretty-bytes-cli – 次模块的 cli 版本
• pretty-ms – 将毫秒转换为人类可读的字符串