hutool.core.io.data_size

数据大小工具模块

Module Contents

Classes

DataSizeUtil

数据大小工具类

API

class hutool.core.io.data_size.DataSizeUtil

数据大小工具类

_UNITS: Dict[str, int] = None

_SIZE_PATTERN = 'compile(...)'

static parse(size_str: str) → int

解析数据大小字符串为字节数

支持的单位（不区分大小写）: B, KB, MB, GB, TB, PB

示例:

DataSizeUtil.parse("10KB")   -> 10240
DataSizeUtil.parse("1.5GB")  -> 1610612736
DataSizeUtil.parse("512 B")  -> 512

参数:

size_str – 数据大小字符串，如 “10KB”、”1.5 GB”

返回:

对应的字节数（int）

抛出:

ValueError – 无法解析时抛出

static format_size(size: int) → str

将字节数格式化为可读字符串

自动选择最合适的单位，保留两位小数并去除末尾的零。

示例:

DataSizeUtil.format_size(10240)       -> "10KB"
DataSizeUtil.format_size(1073741824)   -> "1GB"
DataSizeUtil.format_size(512)          -> "512B"

参数:

size – 字节数

返回:

格式化后的字符串