Provides methods for converting a number into a formatted string that currently represents one of the following forms: phone number, percentage, money, or precision level.
- human_size
- number_to_currency
- number_to_human_size
- number_to_percentage
- number_to_phone
- number_with_delimiter
- number_with_precision
Alias for number_to_human_size
Formats a number into a currency string. The options hash can be used to customize the format of the output. The number can contain a level of precision using the precision key; default is 2 The currency type can be set using the unit key; default is "$" The unit separator can be set using the separator key; default is "." The delimiter can be set using the delimiter key; default is "," 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.50, {:unit => "£", :separator => ",", :delimiter => ""}) => £1234567890,50
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 37
37: def number_to_currency(number, options = {})
38: options = options.stringify_keys
39: precision, unit, separator, delimiter = options.delete("precision") { 2 }, options.delete("unit") { "$" }, options.delete("separator") { "." }, options.delete("delimiter") { "," }
40: separator = "" unless precision > 0
41: begin
42: parts = number_with_precision(number, precision).split('.')
43: unit + number_with_delimiter(parts[0], delimiter) + separator + parts[1].to_s
44: rescue
45: number
46: end
47: end
Returns a formatted-for-humans file size.
Examples:
human_size(123) => 123 Bytes human_size(1234) => 1.2 KB human_size(12345) => 12.1 KB human_size(1234567) => 1.2 MB human_size(1234567890) => 1.1 GB
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 87
87: def number_to_human_size(size)
88: case
89: when size < 1.kilobyte: '%d Bytes' % size
90: when size < 1.megabyte: '%.1f KB' % (size / 1.0.kilobyte)
91: when size < 1.gigabyte: '%.1f MB' % (size / 1.0.megabyte)
92: when size < 1.terabyte: '%.1f GB' % (size / 1.0.gigabyte)
93: else '%.1f TB' % (size / 1.0.terabyte)
94: end.sub('.0', '')
95: rescue
96: nil
97: end
Formats a number as into a percentage string. The options hash can be used to customize the format of the output. The number can contain a level of precision using the precision key; default is 3 The unit separator can be set using the separator key; default is "." Examples:
number_to_percentage(100) => 100.000%
number_to_percentage(100, {:precision => 0}) => 100%
number_to_percentage(302.0574, {:precision => 2}) => 302.06%
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 56
56: def number_to_percentage(number, options = {})
57: options = options.stringify_keys
58: precision, separator = options.delete("precision") { 3 }, options.delete("separator") { "." }
59: begin
60: number = number_with_precision(number, precision)
61: parts = number.split('.')
62: if parts.at(1).nil?
63: parts[0] + "%"
64: else
65: parts[0] + separator + parts[1].to_s + "%"
66: end
67: rescue
68: number
69: end
70: end
Formats a number into a US phone number string. The options can be a hash used to customize the format of the output. The area code can be surrounded by parentheses by setting +:area_code+ to true; default is false The delimiter can be set using +:delimiter+; default is "-" Examples:
number_to_phone(1235551234) => 123-555-1234
number_to_phone(1235551234, {:area_code => true}) => (123) 555-1234
number_to_phone(1235551234, {:delimiter => " "}) => 123 555 1234
number_to_phone(1235551234, {:area_code => true, :extension => 555}) => (123) 555-1234 x 555
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 15
15: def number_to_phone(number, options = {})
16: options = options.stringify_keys
17: area_code = options.delete("area_code") { false }
18: delimiter = options.delete("delimiter") { "-" }
19: extension = options.delete("extension") { "" }
20: begin
21: str = area_code == true ? number.to_s.gsub(/([0-9]{3})([0-9]{3})([0-9]{4})/,"(\\1) \\2#{delimiter}\\3") : number.to_s.gsub(/([0-9]{3})([0-9]{3})([0-9]{4})/,"\\1#{delimiter}\\2#{delimiter}\\3")
22: extension.to_s.strip.empty? ? str : "#{str} x #{extension.to_s.strip}"
23: rescue
24: number
25: end
26: end
Formats a number with a delimiter. Example:
number_with_delimiter(12345678) => 12,345,678
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 75
75: def number_with_delimiter(number, delimiter=",")
76: number.to_s.gsub(/(\d)(?=(\d\d\d)+(?!\d))/, "\\1#{delimiter}")
77: end
Formats a number with a level of precision. Example:
number_with_precision(111.2345) => 111.235
[ show source ]
# File vendor/rails/actionpack/lib/action_view/helpers/number_helper.rb, line 104
104: def number_with_precision(number, precision=3)
105: sprintf("%01.#{precision}f", number)
106: end