numfmt(1)

💖 numfmt(1) — the General Commands Manual, but make it cute ✨

okay bestie, listen. this is numfmt, from the General Commands Manual section, and it's literally the glow-up machine for numbers. it turns numbers into human-readable strings and back again, and honestly? it ate. 🍓

---

✨ NAME ✨

numfmt — Convert numbers from/to human-readable strings

---

🦋 SYNOPSIS 🦋

numfmt [--debug] [-d|--delimiter] [--field] [--format] [--from]
[--from-unit] [--to] [--to-unit] [--padding] [--header] [--round]
[--suffix] [--unit-separator] [--invalid] [-z|--zero-terminated]
[-h|--help] [-V|--version] [NUMBER]

---

🌸 DESCRIPTION 🌸

Convert numbers from/to human-readable strings.

like. that's the whole vibe. numbers go in, gorgeous strings come out, and vice versa. 💅

---

🎀 OPTIONS 🎀

• --debug — print warnings about invalid input 👀 (she's telling you when something's off)
• -d, --delimiter <X> — use X instead of whitespace for the field delimiter
• --field <FIELDS> — replace the numbers in these input fields; see FIELDS below. (default: 1)
• --format <FORMAT> — use printf style floating-point FORMAT; see FORMAT below for the deets
• --from <UNIT> — auto-scale input numbers to UNITs; see UNIT below. (default: none)
• --from-unit <N> — specify the input unit size. (default: 1)
• --to <UNIT> — auto-scale output numbers to UNITs; see UNIT below. (default: none)
• --to-unit <N> — the output unit size. (default: 1)
• --padding <N> — pad the output to N characters; positive N will right-align; negative N will left-align; padding is ignored if the output is wider than N; the default is to automatically pad if a whitespace is found
• --header [<N>] — print (without converting) the first N header lines; N defaults to 1 if not specified
• --round <METHOD> — use METHOD for rounding when scaling. (default: from-zero)

Possible values:

• up
• down
• from-zero
• towards-zero
• nearest

• --suffix <SUFFIX> — print SUFFIX after each formatted number, and accept inputs optionally ending with SUFFIX
• --unit-separator <STRING> — use STRING to separate the number from any unit when printing; by default, no separator is used
• --invalid <INVALID> — set the failure mode for invalid input. (default: abort)

Possible values:

• abort
• fail
• warn
• ignore

• -z, --zero-terminated — line delimiter is NUL, not newline
• -h, --help — Print help
• -V, --version — Print version

---

💜 EXTRA 💜

not me putting the whole lore dump here but bestie you NEED it 🧚

UNIT options:

• none: no auto-scaling is done; suffixes will trigger an error
• auto: accept optional single/two letter suffix:

1K = 1000, 1Ki = 1024, 1M = 1000000, 1Mi = 1048576,

• si: accept optional single letter suffix:

1K = 1000, 1M = 1000000, ...

• iec: accept optional single letter suffix:

1K = 1024, 1M = 1048576, ...

• iec-i: accept optional two-letter suffix:

1Ki = 1024, 1Mi = 1048576, ...

---

FIELDS supports cut(1) style field ranges:

N N'th field, counted from 1
N- from N'th field, to end of line
N-M from N'th to M'th field (inclusive)
-M from first to M'th field (inclusive)
- all fields

Multiple fields/ranges can be separated with commas 🌈

---

FORMAT must be suitable for printing one floating-point argument %f. Optional quote (%'f) will enable --grouping (if supported by current locale). Optional width value (%10f) will pad output. Optional zero (%010f) width will zero pad the number. Optional negative values (%-10f) will left align. Optional precision (%.1f) will override the input determined precision.

---

👑 VERSION 👑

v(uutils coreutils) 0.7.0

---

and that's the whole page, bestie — mwah 💋 this was numfmt (uutils coreutils) 0.7.0, straight out of the General Commands Manual. periodt. 🫶✨