NUMFMT(1)

НАИМЕНОВАНИЕ
numfmt — преобразовать числа из/в удобочитаемые человеком строки

ОБЗОР
numfmt [ПАРАМЕТР]... [ЧИСЛО]...

ОПИСАНИЕ

Преобразовать ЧИСЛО (ЧИСЛА); если ни одно не указано, преобразовать числа из стандартного потока ввода.

Аргументы, обязательные для длинных параметров, обязательны и для коротких.

--debug
    выводить предупреждения о неправильных входных данных

-d, --delimiter=X
    использовать X вместо пробела в качестве разделителя полей

--field=ПОЛЯ
    заменять числа в указанных полях входных данных (по умолчанию 1); см. ПОЛЯ ниже

--format=ФОРМАТ
    использовать printf-подобный ФОРМАТ чисел с плавающей запятой; см. ФОРМАТ ниже для получения подробностей

--from=ЕДИНИЦЫ_ИЗМЕРЕНИЯ
    автоматически приводить числа во входных данных к ЕДИНИЦАМ_ИЗМЕРЕНИЯ; по умолчанию используется «none»; см. ЕДИНИЦЫ_ИЗМЕРЕНИЯ ниже

--from-unit=N
    задать размер единицы измерения входных данных (вместо значения по умолчанию, равного 1)

--grouping
    группировать цифры в соответствии с региональными настройками, например, 1 000 000 (что означает, что данный параметр не учитывается для региональных настроек C/POSIX)

--header[=N]
    вывести (без преобразования) первые N заголовочных строк; если значение N не указано, оно принимается равным 1 по умолчанию

--invalid=РЕЖИМ
    режим обработки ошибок при обнаружении неверно заданных чисел; РЕЖИМ может принимать следующие значения: abort (по умолчанию), fail, warn, ignore

--padding=N
    дополнять выходные данные до N символов; положительные значения N приводят к выравниванию по правому краю, отрицательные — по левому краю; дополнение не осуществляется, если выходные данные шире, чем N; по умолчанию дополнение происходит автоматически, если во входных данных присутствуют пробелы

--round=МЕТОД
    использовать МЕТОД округления при приведении чисел; МЕТОД может принимать следующие значения: up, down, from-zero (по умолчанию), towards-zero, nearest

--suffix=СУФФИКС
    добавлять СУФФИКС к числам при выводе и допускать наличие необязательного СУФФИКСа у чисел во входных данных

--to=ЕДИНИЦЫ_ИЗМЕРЕНИЯ
    автоматически приводить числа в выходных данных к ЕДИНИЦАМ_ИЗМЕРЕНИЯ; см. ЕДИНИЦЫ_ИЗМЕРЕНИЯ ниже

--to-unit=N
    размер единицы измерения выходных данных (вместо значения по умолчанию, равного 1)

-z, --zero-terminated
    разделять строки символом конца строки NUL вместо перевода на новую строку

--help
    отобразить эту справочную информацию и завершить работу

--version
    вывести информацию о версии и завершить работу

  ЕДИНИЦЫ_ИЗМЕРЕНИЯ:

none
    автоматическое приведение не выполняется, наличие суффиксов приведёт к ошибкам

auto
    принимать необязательный суффикс из одной/двух букв:

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

si  принимать необязательный суффикс из одной буквы:

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

iec принимать необязательный суффикс из одной буквы:

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

iec-i
    принимать необязательный суффикс из двух букв:

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

  ПОЛЯ поддерживают диапазоны полей в стиле cut(1):

N   N-ое поле, отсчитываемое с 1

N-  от N-го поля до конца строки

N-M от N-го до M-го поля включительно

-M  от первого до M-го поля включительно

-   все поля

Несколько полей/диапазонов могут быть перечислены через запятую.

ФОРМАТ должен быть подходящим для вывода одного аргумента с плавающей запятой «%f». Необязательная кавычка (%'f) включит параметр --grouping (если это позволяют текущие региональные настройки). Необязательное значение ширины (%10f) приведёт к дополнению выходных данных до этого значения. Необязательный ноль перед значением ширины (%010f) позволит выполнить дополнение числа нулями. Отрицательное значение ширины (%-10f) приведёт к выравниванию по левому краю. Необязательное указание точности (%.1f) переопределит точность, задаваемую входными данными.

Программа завершится с кодом 0, если все входные числа были успешно преобразованы. По умолчанию при первой ошибке преобразования numfmt прекратит работу и завершится с кодом 2. Если задан параметр --invalid='fail', для каждой ошибки преобразования будет выведено предупреждение, и код завершения будет равен 2. Если задан параметр --invalid='warn', для каждой ошибки преобразования будет выведена диагностическая информация, но код завершения будет равен 0. Если задан параметр --invalid='ignore', диагностическая информация не будет выводиться, и код завершения будет равен 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»

    $ df -B1 | numfmt --header --field 2-4 --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

АВТОРЫ
Программа написана Ассафом Гордоном (Assaf Gordon).

ИНФОРМАЦИЯ ОБ ОШИБКАХ
Онлайн-справка GNU coreutils: <https://www.gnu.org/software/coreutils/>
Сообщайте обо всех ошибках перевода по адресу <https://translationproject.org/team/ru.html>

АВТОРСКИЕ ПРАВА
Copyright © 2025 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
Это свободное программное обеспечение: вы можете изменять и распространять его. Не предоставляется НИКАКИХ ГАРАНТИЙ в той мере, в которой это разрешено законом.

СМОТРИТЕ ТАКЖЕ
Полная документация на <https://www.gnu.org/software/coreutils/numfmt>,
также доступна локально посредством info '(coreutils) numfmt invocation'

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) Андрей Догадкин <adogadkin@outlook.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (<debian-l10n-russian@lists.debian.org>).