ActionView::Helpers::NumberHelper

number_to_human

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

説明

数を、単位の名前を付けた読みやすい形の文字列にして返します。

引数

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

ActiveSupport::NumberHelper の同じ名前のメソッドで、数を文字列にします。このサイトの日本語のページには、数の形の訳（number.human など）を入れていないので、英語の形になります。数でない値（"abc"）を渡すと、エラーにせず、そのまま返します。nil なら nil を返します。
options= {}
{unit: "m", thousand: "km"}
単位の名前の Hash です。key は unit・thousand・million などです。渡した単位の中から、数に合うものを使います。単位の名前はエスケープします。
"%n%u"
%n を数、%u を単位にして並べる形です。渡した文字列はエスケープします。
true にすると、引数の number が数でないときに、InvalidNumberError になります。

数を丸める options

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

ERB

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


          

        


        

          

            
HTML