numfmt - 数値を人間が読みやすい形式に変換
構文
numfmt [オプション]... [数値]...
説明
数値、または指定されていない場合は標準入力から数値を読み込み、再フォーマットします。
長いオプションの必須引数は、短いオプションでも必須です。
--debug
無効な入力に関する警告を表示します。
-d, --delimiter=X
フィールド区切り文字として空白の代わりに X を使用します。
--field=フィールド
入力のこれらのフィールドの数値を置き換えます (デフォルトは 1)。フィールドについては以下を参照してください。
--format=フォーマット
printf スタイルの浮動小数点フォーマットを使用します。詳細については、以下にあるフォーマットを参照してください。
--from=単位
入力数値を単位に自動的にスケールします。デフォルトは「なし」です。単位については以下を参照してください。
--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 は左揃えになります。出力が N より広い場合は、埋め込みは無視されます。デフォルトでは、空白が見つかった場合に自動的に埋め込みます。
--round=メソッド
スケーリング時に、メソッドを使用して丸めます。メソッドは次のとおりです: up, down, from-zero (デフォルト), towards-zero, nearest
--suffix=サフィックス
出力数値にサフィックスを追加し、入力数値でオプションのサフィックスを受け入れます。
--to=単位
出力数値を単位に自動的にスケールします。単位については以下を参照してください。
--to-unit=N
出力単位サイズを指定します (デフォルトは 1)。
-z, --zero-terminated
行区切り文字は NULL で、改行ではありません。
--help このヘルプを表示して終了します。
--version バージョン情報を出力して終了します。
単位オプション:
none 単位による自動スケーリングは行われません。サフィックスが存在する場合はエラーが発生します。
auto オプションの 1 文字または 2 文字のサフィックスを受け入れます: 1K = 1000, 1k = 1000, 1Ki = 1024, 1M = 1000000, 1i = 1048576, ...
si オプションの 1 文字のサフィックスを受け入れます: 1k = 1000, 1K = 1000, 1M = 1000000, ...
iec オプションの 1 文字のサフィックスを受け入れます: 1K = 1024, 1k = 1024, 1M = 1048576, ...
iec-i オプションの 2 文字のサフィックスを受け入れます: 1Ki = 1024, 1ki = 1024, 1Mi = 1048576, ...
フィールドは cut(1) スタイルのフィールド範囲をサポートします:
N N 番目のフィールド (1 からカウント)
N- N 番目から最後のフィールドまで
N-M N 番目から M 番目のフィールドまで (両端を含む)
-M 最初のフィールドから M 番目のフィールドまで (両端を含む)
- すべてのフィールド
複数のフィールド/範囲はカンマで区切ることができます。
FORMAT は、浮動小数点引数を 1 つ出力するのに適した printf スタイルである必要があります '%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/] に報告してください。
関連項目
完全なドキュメント [https://www.gnu.org/software/coreutils/numfmt] または、ローカルで利用可能: info '(coreutils) numfmt invocation'
Debian (9.7-3) でパッケージ化。 著作権 © 2025 Free Software Foundation, Inc. ライセンス GPLv3+: GNU GPL バージョン 3 またはそれ以降 [https://gnu.org/licenses/gpl.html]。 これはフリーソフトウェアです。自由に修正して再配布できます。 法で許可されている範囲で、保証は一切ありません。