Manpage logo

numfmt - numfmt

NAME  SYNOPSIS  DESCRIPTION  OPTIONS 

NAME

numfmt − numfmt

SYNOPSIS

numfmt [OPTION]... [NUMBER]...

DESCRIPTION

Convert numbers from/to human−readable strings

OPTIONS

−d, −−delimiter <X>

use X instead of whitespace for 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 details

−−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

−−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

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.


Updated 2026-06-01 - jenkler.se | uex.se