Module: Padrino::Helpers::NumberHelpers

Defined in:
padrino-helpers/lib/padrino-helpers/number_helpers.rb

Overview

Provides methods for converting numbers into formatted strings. Methods are provided for phone numbers, currency, percentage, precision, positional notation, and file size.

Adapted from Rails Number Helpers.

Constant Summary

STORAGE_UNITS =

The units available for storage formatting.

[:byte, :kb, :mb, :gb, :tb].freeze

Instance Method Summary collapse

Instance Method Details

#number_to_currency(number, options = {}) ⇒ String

Formats a number into a currency string (e.g., $13.65). You can customize the format in the options hash.

Examples:

number_to_currency(1234567890.50)                    # => $1,234,567,890.50
number_to_currency(1234567890.506)                   # => $1,234,567,890.51
number_to_currency(1234567890.506, :precision => 3)  # => $1,234,567,890.506
number_to_currency(1234567890.50, :unit => "£", :separator => ",", :delimiter => "")
# => £1234567890,50
number_to_currency(1234567890.50, :unit => "£", :separator => ",", :delimiter => "", :format => "%n %u")
# => 1234567890,50 £

Options Hash (options):

  • :precision (Integer) — default: 2

    Sets the level of precision.

  • :unit (String) — default: "$"

    Sets the denomination of the currency.

  • :separator (String) — default: "."

    Sets the separator between the units.

  • :delimiter (String) — default: ","

    Sets the thousands delimiter.

  • :format (String) — default: "%u%n"

    Sets the format of the output string. The field types are:

    %u  The currency unit
    %n  The number


43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# File 'padrino-helpers/lib/padrino-helpers/number_helpers.rb', line 43

def number_to_currency(number, options = {})
  options = Utils.symbolize_keys(options)

  defaults  = I18n.translate(:number.format', :locale => options[:locale], :raise => true) rescue {}
  currency  = I18n.translate(:number.currency.format', :locale => options[:locale], :raise => true) rescue {}
  defaults  = defaults.merge(currency)

  precision = options[:precision] || defaults[:precision]
  unit      = options[:unit]      || defaults[:unit]
  separator = options[:separator] || defaults[:separator]
  delimiter = options[:delimiter] || defaults[:delimiter]
  format    = options[:format]    || defaults[:format]
  separator = '' if precision == 0

  begin
    format.gsub(/%n/, number_with_precision(number,
      :precision => precision,
      :delimiter => delimiter,
      :separator => separator)
    ).gsub(/%u/, unit)
  rescue
    number
  end
end

#number_to_human_size(number, options = {}) ⇒ String

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

Examples:

number_to_human_size(123)                                          # => 123 Bytes
number_to_human_size(1234)                                         # => 1.2 KB
number_to_human_size(12345)                                        # => 12.1 KB
number_to_human_size(1234567)                                      # => 1.2 MB
number_to_human_size(1234567890)                                   # => 1.1 GB
number_to_human_size(1234567890123)                                # => 1.1 TB
number_to_human_size(1234567, :precision => 2)                     # => 1.18 MB
number_to_human_size(483989, :precision => 0)                      # => 473 KB
number_to_human_size(1234567, :precision => 2, :separator => ',')  # => 1,18 MB

Options Hash (options):

  • :precision (Integer) — default: 1

    Sets the level of precision.

  • :separator (String) — default: "."

    Sets the separator between the units.

  • :delimiter (String) — default: ""

    Sets the thousands delimiter.



237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
# File 'padrino-helpers/lib/padrino-helpers/number_helpers.rb', line 237

def number_to_human_size(number, *args)
  return nil if number.nil?

  options = args.last.is_a?(Hash) ? Utils.symbolize_keys(args.pop) : {}

  defaults = I18n.translate(:number.format', :locale => options[:locale], :raise => true) rescue {}
  human    = I18n.translate(:number.human.format', :locale => options[:locale], :raise => true) rescue {}
  defaults = defaults.merge(human)

  precision ||= (options[:precision] || defaults[:precision])
  separator ||= (options[:separator] || defaults[:separator])
  delimiter ||= (options[:delimiter] || defaults[:delimiter])

  storage_units_format = I18n.translate(:number.human.storage_units.format', :locale => options[:locale], :raise => true)

  if number.to_i < 1024
    unit = I18n.translate(:number.human.storage_units.units.byte', :locale => options[:locale], :count => number.to_i, :raise => true)
    storage_units_format.gsub(/%n/, number.to_i.to_s).gsub(/%u/, unit)
  else
    max_exp  = STORAGE_UNITS.size - 1
    number   = Float(number)
    exponent = (Math.log(number) / Math.log(1024)).to_i # Convert to base 1024
    exponent = max_exp if exponent > max_exp # we need this to avoid overflow for the highest unit
    number  /= 1024 ** exponent

    unit_key = STORAGE_UNITS[exponent]
    unit = I18n.translate(:number.human.storage_units.units.#{unit_key}", :locale => options[:locale], :count => number, :raise => true)

    begin
      escaped_separator = Regexp.escape(separator)
      formatted_number = number_with_precision(number,
        :precision => precision,
        :separator => separator,
        :delimiter => delimiter
      ).sub(/(#{escaped_separator})(\d*[1-9])?0+\z/, '\1\2').sub(/#{escaped_separator}\z/, '')
      storage_units_format.gsub(/%n/, formatted_number).gsub(/%u/, unit)
    rescue
      number
    end
  end
end

#number_to_percentage(number, options = {}) ⇒ String

Formats a number as a percentage string (e.g., 65%). You can customize the format in the options hash.

Examples:

number_to_percentage(100)                                        # => 100.000%
number_to_percentage(100, :precision => 0)                       # => 100%
number_to_percentage(1000, :delimiter => '.', :separator => ',') # => 1.000,000%
number_to_percentage(302.24398923423, :precision => 5)           # => 302.24399%

Options Hash (options):

  • :precision (Integer) — default: 3

    Sets the level of precision.

  • :separator (String) — default: "."

    Sets the separator between the units.

  • :delimiter (String) — default: ""

    Sets the thousands delimiter.



91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
# File 'padrino-helpers/lib/padrino-helpers/number_helpers.rb', line 91

def number_to_percentage(number, options = {})
  options = Utils.symbolize_keys(options)

  defaults   = I18n.translate(:number.format', :locale => options[:locale], :raise => true) rescue {}
  percentage = I18n.translate(:number.percentage.format', :locale => options[:locale], :raise => true) rescue {}
  defaults  = defaults.merge(percentage)

  precision = options[:precision] || defaults[:precision]
  separator = options[:separator] || defaults[:separator]
  delimiter = options[:delimiter] || defaults[:delimiter]

  begin
    number_with_precision(number,
      :precision => precision,
      :separator => separator,
      :delimiter => delimiter) + "%"
  rescue
    number
  end
end

#number_with_delimiter(number, options = {}) ⇒ String

Formats a number with grouped thousands using delimiter (e.g., 12,324). You can customize the format in the options hash.

Examples:

number_with_delimiter(12345678)                        # => 12,345,678
number_with_delimiter(12345678.05)                     # => 12,345,678.05
number_with_delimiter(12345678, :delimiter => ".")     # => 12.345.678
number_with_delimiter(12345678, :separator => ",")     # => 12,345,678
number_with_delimiter(98765432.98, :delimiter => " ", :separator => ",")
# => 98 765 432,98

Options Hash (options):

  • :delimiter (String) — default: ", "

    Sets the thousands delimiter.

  • :separator (String) — default: "."

    Sets the separator between the units.



136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
# File 'padrino-helpers/lib/padrino-helpers/number_helpers.rb', line 136

def number_with_delimiter(number, *args)
  options = args.last.is_a?(Hash) ? Utils.symbolize_keys(args.pop) : {}

  defaults = I18n.translate(:number.format', :locale => options[:locale], :raise => true) rescue {}

  delimiter ||= (options[:delimiter] || defaults[:delimiter])
  separator ||= (options[:separator] || defaults[:separator])

  begin
    parts = number.to_s.split('.')
    parts[0].gsub!(/(\d)(?=(\d\d\d)+(?!\d))/, "\\1#{delimiter}")
    parts.join(separator)
  rescue
    number
  end
end

#number_with_precision(number, options = {}) ⇒ String

Formats a number with the specified level of :precision (e.g., 112.32 has a precision of 2). You can customize the format in the options hash.

Examples:

number_with_precision(111.2345)                    # => 111.235
number_with_precision(111.2345, :precision => 2)   # => 111.23
number_with_precision(13, :precision => 5)         # => 13.00000
number_with_precision(389.32314, :precision => 0)  # => 389
number_with_precision(1111.2345, :precision => 2, :separator => ',', :delimiter => '.')
# => 1.111,23

Options Hash (options):

  • :precision (Integer) — default: 3

    Sets the level of precision.

  • :separator (String) — default: "."

    Sets the separator between the units.

  • :delimiter (String) — default: ""

    Sets the thousands delimiter.



179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
# File 'padrino-helpers/lib/padrino-helpers/number_helpers.rb', line 179

def number_with_precision(number, *args)
  options = args.last.is_a?(Hash) ? Utils.symbolize_keys(args.pop) : {}

  defaults           = I18n.translate(:number.format', :locale => options[:locale], :raise => true) rescue {}
  precision_defaults = I18n.translate(:number.precision.format', :locale => options[:locale],
                                                                  :raise => true) rescue {}
  defaults           = defaults.merge(precision_defaults)

  precision ||= (options[:precision] || defaults[:precision])
  separator ||= (options[:separator] || defaults[:separator])
  delimiter ||= (options[:delimiter] || defaults[:delimiter])

  begin
    rounded_number = (Float(number) * (10 ** precision)).round.to_f / 10 ** precision
    number_with_delimiter("%01.#{precision}f" % rounded_number,
      :separator => separator,
      :delimiter => delimiter)
  rescue
    number
  end
end