函数 formatBytes

  • formatBytes(bytes, options?): string

  • 格式化字节数

    参数

    • bytes: number

      字节数

    • options: {
          fractionDigits?: number;
          exponential?: boolean;
          unit?: BYTE_UNIT;
      } = {}
      • 可选fractionDigits?: number

        指定小数位；默认2

      • 可选exponential?: boolean

        是否使用科学计数法；默认false

      • 可选unit?: BYTE_UNIT

        指定单位

    返回 string

    示例

    formatBytes(0); // '0B'
    formatBytes(1); // '1B'
    formatBytes(-1); // '-1B'

    formatBytes(1024); // '1KB'
    formatBytes(1024 * 1024); // '1MB'
    formatBytes(1024 * 1024 * 1024); // '1GB'
    formatBytes(1024 * 1024 * 1024 * 1024); // '1TB'
    formatBytes(1024 * 1024 * 1024 * 1024 * 1024); // '1PB'
    formatBytes(1024 ** 6); // '1EB'
    formatBytes(1024 ** 7); // '1ZB'
    formatBytes(1024 ** 8); // '1YB'

    formatBytes(1024 * 512 + 1000); // '512.98KB'

    // 指定单位
    formatBytes(1024 * 512, { unit: 'MB' }); // '0.5MB'
    formatBytes(1024 * 512, { unit: 'GB' }); // '0GB'
    // 指定小数位
    formatBytes(1024 * 512, { unit: 'GB', fractionDigits: 5 }); // '0.00049GB'
    formatBytes(1, { unit: 'GB', fractionDigits: 9 }); // '0.000000001GB'
    // 使用科学计数法
    formatBytes(1, { unit: 'GB', fractionDigits: 9, exponential: true }); // '1e-9GB'