instance method number_to_rounded

Ruby on Rails 8.0.4

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 number to a specific level of precision.

number_to_rounded(12345.6789)                # => "12345.679"
number_to_rounded(12345.6789, precision: 2)  # => "12345.68"
number_to_rounded(12345.6789, precision: 0)  # => "12345"
number_to_rounded(12345, precision: 5)       # => "12345.00000"

Options

:locale

The locale to use for formatting. Defaults to the current locale.

number_to_rounded(111.234, locale: :fr)
# => "111,234"
:precision

The level of precision, or nil to preserve number‘s precision. Defaults to 3.

number_to_rounded(12345.6789, precision: nil)
# => "12345.6789"
:round_mode

Specifies how rounding is performed. See BigDecimal.mode. Defaults to :default.

number_to_rounded(12.34, precision: 0, round_mode: :up)
# => "13"
:significant

Whether :precision should be applied to significant digits instead of fractional digits. Defaults to false.

number_to_rounded(12345.6789)                                  # => "12345.679"
number_to_rounded(12345.6789, significant: true)               # => "12300"
number_to_rounded(12345.6789, precision: 2)                    # => "12345.68"
number_to_rounded(12345.6789, precision: 2, significant: true) # => "12000"
:separator

The decimal separator. Defaults to ".".

:delimiter

The thousands delimiter. Defaults to ",".

:strip_insignificant_zeros

Whether to remove insignificant zeros after the decimal separator. Defaults to false.

number_to_rounded(12.34, strip_insignificant_zeros: false)  # => "12.340"
number_to_rounded(12.34, strip_insignificant_zeros: true)   # => "12.34"
number_to_rounded(12.3456, strip_insignificant_zeros: true) # => "12.346"

Parameters

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

Defined in activesupport/lib/active_support/number_helper.rb line 320 · 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