类型转换工具 - ConvertUtil¶

由来¶

类型转换是日常开发中最常见的操作之一。ConvertUtil 提供 bytes↔int、通用类型转换、安全字符串转换等常用方法。

方法¶

字节转换¶

from hutool import ConvertUtil

# bytes → int（大端序）
ConvertUtil.bytes_to_int(b"\x00\x00\x01\x00")  # 256
ConvertUtil.bytes_to_int(b"\xff")  # 255

# int → bytes（大端序）
ConvertUtil.int_to_bytes(256, 2)  # b'\x01\x00'
ConvertUtil.int_to_bytes(1, 4)  # b'\x00\x00\x00\x01'
ConvertUtil.int_to_bytes(0, 1)  # b'\x00'

安全字符串转换¶

# bytes/bytearray 自动解码
ConvertUtil.to_str(b"hello")  # 'hello'

# 其他类型使用 str()
ConvertUtil.to_str(123)  # '123'
ConvertUtil.to_str(None)  # ''

# 自定义编码
ConvertUtil.to_str(b"\xc4\xe3\xba\xc3", "gb2312")  # '你好'

通用类型转换¶

ConvertUtil.convert("123", int)  # 123
ConvertUtil.convert(3.14, str)  # '3.14'
ConvertUtil.convert("true", bool)  # True
ConvertUtil.convert(None, int)  # 0
ConvertUtil.convert(None, str)  # ''

中文数字转换¶

# 数字转中文
ConvertUtil.number_to_chinese(123)  # "一百二十三"
ConvertUtil.number_to_chinese(10001)  # "一万零一"

# 数字转中文大写
ConvertUtil.digit_to_chinese(123)  # "壹佰贰拾叁"
ConvertUtil.digit_to_chinese(10000)  # "壹万"

# 中文转数字
ConvertUtil.chinese_to_number("一百二十三")  # 123
ConvertUtil.chinese_to_number("一万零一")  # 10001

英文数字¶

# 数字转英文
ConvertUtil.number_to_word(123)  # "one hundred and twenty-three"
ConvertUtil.number_to_word(0)  # "zero"

中文金额¶

# 中文金额转数字
ConvertUtil.chinese_money_to_number("壹佰贰拾叁元整")  # 123.0
ConvertUtil.chinese_money_to_number("叁万零伍拾")  # 30050.0

数字简写¶

# 数字简写（千/万/亿）
ConvertUtil.number_to_simple(1234)  # "1.2K"
ConvertUtil.number_to_simple(1234567)  # "1.2M"
ConvertUtil.number_to_simple(12345678)  # "1234.6万"

全角/半角转换¶

# 全角转半角
ConvertUtil.to_dbc("Ｈｅｌｌｏ")  # "Hello"
ConvertUtil.to_dbc("１２３")  # "123"

# 半角转全角
ConvertUtil.to_sbc("Hello")  # "Ｈｅｌｌｏ"
ConvertUtil.to_sbc("123")  # "１２３"

表格格式化¶

# 字典转表格字符串
data = [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]
ConvertUtil.dict_to_tabular(data)
# name    age
# Alice   30
# Bob     25

# 列表转表格字符串
ConvertUtil.list_to_tabular([[1, 2], [3, 4]], headers=["A", "B"])
# A  B
# 1  2
# 3  4

备注

更多方法请参阅 API 参考文档。