instance method number_to_rounded

Ruby on Rails 5.2.8.1

Since v4.0.13

Available in: v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Signature

number_to_rounded(number, options = {})

Formats a number with the specified level of :precision (e.g., 112.32 has a precision of 2 if :significant is false, and 5 if :significant is true). You can customize the format in the options hash.

Options

  • :locale - Sets the locale to be used for formatting (defaults to current locale).

  • :precision - Sets the precision of the number (defaults to 3). Keeps the number’s precision if nil.

  • :significant - If true, precision will be the number of significant_digits. If false, the number of fractional digits (defaults to false).

  • :separator - Sets the separator between the fractional and integer digits (defaults to “.”).

  • :delimiter - Sets the thousands delimiter (defaults to “”).

  • :strip_insignificant_zeros - If true removes insignificant zeros after the decimal separator (defaults to false).

Examples

number_to_rounded(111.2345)                                  # => "111.235"
number_to_rounded(111.2345, precision: 2)                    # => "111.23"
number_to_rounded(13, precision: 5)                          # => "13.00000"
number_to_rounded(389.32314, precision: 0)                   # => "389"
number_to_rounded(111.2345, significant: true)               # => "111"
number_to_rounded(111.2345, precision: 1, significant: true) # => "100"
number_to_rounded(13, precision: 5, significant: true)       # => "13.000"
number_to_rounded(13, precision: nil)                        # => "13"
number_to_rounded(111.234, locale: :fr)                      # => "111,234"

number_to_rounded(13, precision: 5, significant: true, strip_insignificant_zeros: true)
# => "13"

number_to_rounded(389.32314, precision: 4, significant: true) # => "389.3"
number_to_rounded(1111.2345, precision: 2, separator: ',', delimiter: '.')
# => "1.111,23"

Parameters

number req
options opt = {}
Source
# File activesupport/lib/active_support/number_helper.rb, line 219
    def number_to_rounded(number, options = {})
      NumberToRoundedConverter.convert(number, options)
    end

Defined in activesupport/lib/active_support/number_helper.rb line 219 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveSupport::NumberHelper

Type at least 2 characters to search.

↑↓ navigate · open · esc close