NAME
numfmt - Convert numbers from/to human-readable strings
SYNOPSIS
numfmt [OPTION]... [NUMBER]...
DESCRIPTION
Reformat NUMBER(s), or the numbers from standard input if none are
specified.
Mandatory arguments to long options are mandatory for short options
too.
debug
print warnings about invalid input
-d, delimiter=X
use X instead of whitespace for field delimiter
field=N
replace the number in input field N (default is 1)
format=FORMAT
use printf style floating-point FORMAT; see FORMAT below for
details
from=UNIT
auto-scale input numbers to UNITs; default is 'none'; see UNIT
below
from-unit=N
specify the input unit size (instead of the default 1)
grouping
use locale-defined grouping of digits, e.g. 1,000,000 (which
means it has no effect in the C/POSIX locale)
header[=N]
print (without converting) the first N header lines; N defaults
to 1 if not specified
invalid=MODE
failure mode for invalid numbers: MODE can be: abort (default),
fail, warn, ignore
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 white‐
space is found
round=METHOD
use METHOD for rounding when scaling; METHOD can be: up, down,
from-zero (default), towards-zero, nearest
suffix=SUFFIX
add SUFFIX to output numbers, and accept optional SUFFIX in
input numbers
to=UNIT
auto-scale output numbers to UNITs; see UNIT below
to-unit=N
the output unit size (instead of the default 1)
help display this help and exit
version
output version information and exit
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, ...
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 nega‐
tive width values (%-10f) will left-pad output.
Exit status is 0 if all input numbers were successfully converted. By
default, numfmt will stop at the first conversion error with exit sta‐
tus 2. With invalid='fail' a warning is printed for each conversion
error and the exit status is 2. With invalid='warn' each conversion
error is diagnosed, but the exit status is 0. With invalid='ignore'
conversion errors are not diagnosed and the exit status is 0.
EXAMPLES
$ numfmt to=si 1000
-> "1.0K"
$ numfmt to=iec 2048
-> "2.0K"
$ numfmt to=iec-i 4096
-> "4.0Ki"
$ echo 1K | numfmt from=si
-> "1000"
$ echo 1K | numfmt from=iec
-> "1024"
$ df | numfmt header field 2 to=si
$ ls -l | numfmt header field 5 to=iec
$ ls -lh | numfmt header field 5 from=iec padding=10
$ ls -lh | numfmt header field 5 from=iec format %10f
GNU coreutils online help:
Report numfmt translation bugs to
AUTHOR
Written by Assaf Gordon.
COPYRIGHT
Copyright © 2013 Free Software Foundation, Inc. License GPLv3+: GNU
GPL version 3 or later .
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
The full documentation for numfmt is maintained as a Texinfo manual.
If the info and numfmt programs are properly installed at your site,
the command
info coreutils 'numfmt invocation'
should give you access to the complete manual.
GNU coreutils 8.22 October 2018 NUMFMT(1)