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

       Reformat  NUMBER(s),  or  the  numbers  from standard input if none are

       Mandatory arguments to long options are  mandatory  for  short  options

              print warnings about invalid input

       -d, --delimiter=X
              use X instead of whitespace for field delimiter

              replace the number in input field N (default is 1)

              use  printf  style  floating-point  FORMAT; see FORMAT below for

              auto-scale input numbers to UNITs; default is 'none';  see  UNIT

              specify the input unit size (instead of the default 1)

              use  locale-defined  grouping  of  digits, e.g. 1,000,000 (which
              means it has no effect in the C/POSIX locale)

              print (without converting) the first N header lines; N  defaults
              to 1 if not specified

              failure  mode for invalid numbers: MODE can be: abort (default),
              fail, warn, ignore

              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

              use  METHOD  for rounding when scaling; METHOD can be: up, down,
              from-zero (default), towards-zero, nearest

              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.

              $ 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"

       Report numfmt translation bugs to <>

       Copyright  (C) 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.

       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.21                March 2016                         NUMFMT(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2019 Hurricane Electric. All Rights Reserved.