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 – 将毫秒转换为人类可读的字符串