ActionView::Helpers::NumberHelper

number_to_human_size

API ドキュメント（Rails 8.1.4.1） ↗
def number_to_human_size(number, options = {})

説明

バイト数を、KB や MB を付けた文字列にして返します。

引数

値を変えると、ERB と HTML が変わります。

ActiveSupport::NumberHelper の同じ名前のメソッドで、数を文字列にします。このサイトの日本語のページには、数の形の訳（number.human など）を入れていないので、英語の形になります。数でない値（"abc"）を渡すと、エラーにせず、そのまま返します。nil なら nil を返します。1024 より小さい数は、小数点のあとを切り捨てて、丸める options を使いません。
options= {}
true にすると、引数の number が数でないときに、InvalidNumberError になります。

数を丸める options

2
有効数字の桁数です。significant を false にしたときは、小数点のあとの桁数です。
true にすると、precision を有効数字の桁数として扱います。false にすると、小数点のあとの桁数として扱います。precision が 0 のときは、true でも整数に丸めます。
true にすると、小数点のあとの末尾の 0 を消します。false にすると、precision の桁数まで 0 を残します。
丸め方です。:down なら切り捨て、:up なら切り上げにします。デフォルトは四捨五入です。ほかに、BigDecimal の丸め方（:half_even、:half_down、:ceiling、:floor など）も渡せます。
","
小数点の代わりに使う文字列です。渡した文字列はエスケープします。
"."
3 桁ごとの区切りに使う文字列です。渡した文字列はエスケープします。単位で割ったあとの数が 1000 以上のときだけ使います（1024 で割るので、1,020 KB のように 1000 から 1023 になるときと、ZB より大きいとき）。separator と同じ文字列（.）にすると、末尾の 0 を消す処理が区切りのあとの 0 も消すので、桁が変わって見えます（1.020 KB が 1.02 KB になります）。
数を丸める options は、NumberHelper のどのヘルパーでも同じように処理します（ActiveSupport::NumberHelper の NumberToRoundedConverter）。デフォルトの値は、ヘルパーごとに違います。ここにない options は、HTML 属性になりません。locale を渡すと、その言語の数の形の訳（number.human.storage_units など）を使います。このサイトは数の形の訳を用意していないので、:ja を渡しても、Rails が持っている英語の形になります（このサイトにない言語を渡すと、I18n::InvalidLocale になります）。

ERB

直前との違い： 追加 削除 変更


          

        


        

          

            
HTML