普贤教程 › 包参考

human 包

人类可读格式化

项	值
包名	`human`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`human.px`
分类	`文本与中文处理`
文件数 / 行数	`1 / 196`

安装与引入

bash

pxpkg init          # 首次
pxpkg add human@0.2.0
pxpkg install

import human

所属分类教程：文本与中文处理

公开接口

函数	参数
`hm_filesize`	`n`
`hm_number`	`n, suffix = ""`

其余 8 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`hm_fmt1`	`x`
`hm_ordinal`	`n`
`hm_comma`	`n`
`hm_percentage`	`v, decimals = 2`
`hm_duration`	`seconds`
`hm_truncate`	`s, max_len, ellipsis = "..."`
`hm_filesize_si`	`n`
`hm_relative_time`	`delta_seconds`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/human —— 人类可读格式化
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
hm_filesize(n)    → "B/KB/MB/GB/TB/PB"（1024 进制；<10 时一位小数，否则整数）
hm_number(n, suffix="") → "k/M/B/T/P"（1000 进制；同上规则，可带单位后缀）
格式化规则（自定，对齐常见 CLI 简写，单位无空格）：
1024 → "1KB"；1536 → "1.5KB"；828 → "828B"；1_000_000 → "1M"
实现：float 除法 + int 数学四舍五入（避免 float 序列化尾数噪声）。
============================================================
float → 一位小数（若小数位为 0 显示整数；处理进位）