instance method number_to_human_size

Formats the bytes in number into a more understandable representation (e.g., giving it 1500 yields 1.46 KB). This method is useful for reporting file sizes to users. You can customize the format in the options hash.

See number_to_human if you want to pretty-print a generic number.

Options

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

• :precision - Sets the precision of the number (defaults to 3).

• :round_mode - Determine how rounding is performed (defaults to :default. See BigDecimal::mode)

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

• :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 true)

Examples

number_to_human_size(123)                                    # => "123 Bytes"
number_to_human_size(1234)                                   # => "1.21 KB"
number_to_human_size(12345)                                  # => "12.1 KB"
number_to_human_size(1234567)                                # => "1.18 MB"
number_to_human_size(1234567890)                             # => "1.15 GB"
number_to_human_size(1234567890123)                          # => "1.12 TB"
number_to_human_size(1234567890123456)                       # => "1.1 PB"
number_to_human_size(1234567890123456789)                    # => "1.07 EB"
number_to_human_size(1234567, precision: 2)                  # => "1.2 MB"
number_to_human_size(483989, precision: 2)                   # => "470 KB"
number_to_human_size(483989, precision: 2, round_mode: :up)  # => "480 KB"
number_to_human_size(1234567, precision: 2, separator: ',')  # => "1,2 MB"
number_to_human_size(1234567890123, precision: 5)            # => "1.1228 TB"
number_to_human_size(524288000, precision: 5)                # => "500 MB"