numfmt 命令

常用示例

说明

numfmt converts numbers to and from human-readable representations. It handles both SI units (powers of 1000: K, M, G) and IEC units (powers of 1024: Ki, Mi, Gi). Input parsing (--from) interprets suffixed numbers: 10K becomes 10000 (SI) or 10240 (IEC). Output conversion (--to) formats numbers with appropriate suffixes for readability. For processing command output, --field selects which column to convert, and --header preserves header rows. This enables piping output from commands like df or ls through numfmt for human-readable conversion. The --format option provides printf-style control: `%10.2f` for fixed-width decimal output. Combined with --grouping, numbers display with locale-appropriate thousands separators. Rounding modes control how fractional values are handled. The default rounds to nearest, but ceiling (up) or floor (down) may be preferred for storage calculations.

参数

--from= _UNIT_

Parse input units (auto, si, iec, iec-i).

--to= _UNIT_

Convert to units (si, iec, iec-i).

--field= _N_

Convert field N (default: 1).

--header=_N_

Skip N header lines (default: 1).

--padding= _N_

Pad output to N characters.

--suffix= _STR_

Append suffix to output.

--format= _FMT_

Printf-style format.

--round= _METHOD_

Rounding: up, down, from-zero, towards-zero, nearest.

--grouping

Use locale digit grouping (e.g., 1,000).

--delimiter= _D_

Use D as field delimiter.

--invalid= _MODE_

Handle invalid input: abort, fail, warn, ignore.

-d _D_

Short for --delimiter.

--debug

Print conversion warnings.