numfmt - Converte números de/para strings legíveis por humanos
SINTAXE
numfmt [OPÇÃO]... [NÚMERO]...
DESCRIÇÃO
Reformata NÚMERO(s), ou os números da entrada padrão se nenhum for especificado.
Os argumentos obrigatórios para opções longas também são obrigatórios para opções curtas.
--debug
imprime avisos sobre entradas inválidas
-d, --delimiter=X
usa X em vez de espaço em branco como delimitador de campo
--field=CAMPOS
substitui os números nesses campos de entrada (o padrão é 1); veja CAMPOS abaixo
--format=FORMATO
usa FORMATO de ponto flutuante no estilo printf; veja FORMATO abaixo para obter detalhes
--from=UNIDADE
ajusta automaticamente os números de entrada para UNIDADES; o padrão é 'nenhum'; veja UNIDADE abaixo
--from-unit=N
especifica o tamanho da unidade de entrada (em vez do padrão 1)
--grouping
usa o agrupamento de dígitos definido pelo local, por exemplo, 1.000.000 (o que significa que não tem efeito no local C/POSIX)
--header[=N]
imprime (sem converter) as primeiras N linhas de cabeçalho; N tem como padrão 1, se não especificado
--invalid=MODO
modo de falha para números inválidos: MODO pode ser: abort (padrão), fail, warn, ignore
--padding=N
preenche a saída para N caracteres; N positivo alinhará à direita; N negativo alinhará à esquerda; o preenchimento é ignorado se a saída for mais larga que N; o padrão é preencher automaticamente se um espaço em branco for encontrado
--round=MÉTODO
usa MÉTODO para arredondamento durante o ajuste; MÉTODO pode ser: up, down, from-zero (padrão), towards-zero, nearest
--suffix=SUFIXO
adiciona SUFIXO aos números de saída e aceita SUFIXO opcional nos números de entrada
--to=UNIDADE
ajusta automaticamente os números de saída para UNIDADES; veja UNIDADE abaixo
--to-unit=N
o tamanho da unidade de saída (em vez do padrão 1)
-z, --zero-terminated
o delimitador de linha é NUL, não nova linha
--help exibe esta ajuda e sai
--version
exibe informações da versão e sai
Opções de UNIDADE:
none nenhum ajuste automático é feito; os sufixos acionarão um erro
auto aceita sufixo opcional de uma ou duas letras: 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000,
1i = 1048576,
si aceita sufixo opcional de uma letra: 1k = 1000, 1K = 1000, 1M = 1000000, ...
iec aceita sufixo opcional de uma letra: 1K = 1024, 1k = 1024, 1M = 1048576, ...
iec-i aceita sufixo de duas letras opcional: 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...
FIELDS suporta intervalos de campo no estilo cut(1):
N N-ésimo campo, contado a partir de 1
N- a partir do N-ésimo campo, até o final da linha
N-M do N-ésimo ao M-ésimo campo (inclusive)
-M do primeiro ao M-ésimo campo (inclusive)
- todos os campos
Vários campos/intervalos podem ser separados por vírgulas
FORMATO deve ser adequado para imprimir um argumento de ponto flutuante '%f'. Opcional aspas simples (% 'f) ativará --grouping (se suportado pelo local atual). Opcional valor de largura (% 10f) preencherá a saída. Opcional largura zero (% 010f) preencherá o número com zeros. Opcional valores negativos (% -10f) alinharão à esquerda. Opcional precisão (%. 1f) substituirá a precisão determinada da entrada.
O status de saída é 0 se todos os números de entrada forem convertidos com sucesso. Por padrão, o numfmt parará no primeiro erro de conversão com status de saída 2. Com --invalid='fail', um aviso será impresso para cada erro de conversão e o status de saída será 2. Com --invalid='warn', cada erro de conversão será diagnosticado, mas o status de saída será 0. Com --invalid='ignore', os erros de conversão não serão diagnosticados e o status de saída será 0.
EXEMPLOS
$ 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
AUTOR
Escrito por Assaf Gordon.
RELATANDO BUGS
Ajuda online do GNU coreutils: [https://www.gnu.org/software/coreutils/] Relate quaisquer bugs de tradução para [https://translationproject.org/team/]
VER TAMBÉM
Documentação completa [https://www.gnu.org/software/coreutils/numfmt] ou disponível localmente via: info '(coreutils) numfmt invocation'
Empacotado por Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL versão 3 ou posterior [https://gnu.org/licenses/gpl.html]. Este é um software livre: você pode alterar e redistribuí-lo. NÃO HÁ GARANTIA, na medida permitida por lei.