Module: Cybertrain::NumberHelper
- Defined in:
- cybertrain/number_helper.rb
Class Method Summary collapse
-
.number_to_currency(number, unit: "$", precision: 2, format: "%u%n", delimiter: ",", separator: ".") ⇒ Object
1234.5 -> “$1,234.50”; a negative number takes “-“ before the format.
-
.number_to_human(number, precision: 3, units: {}, format: "%n %u", delimiter: "", separator: ".") ⇒ Object
1234 -> “1.23 Thousand”:
precisionsignificant digits, insignificant zeros stripped; units: { unit:, thousand:, million:, billion:, trillion:, quadrillion: } replaces the names;format:places the number (%n) and the unit (%u), the result stripped as Rails strips it (“123” for a number below a thousand). -
.number_to_human_size(number) ⇒ Object
1234 -> “1.21 KB” (base 1024, 3 significant digits).
-
.number_to_percentage(number, precision: 3, format: "%n%", delimiter: "", separator: ".") ⇒ Object
100 -> “100.000%”;
format:places the number (%n). -
.number_with_delimiter(number, delimiter: ",", separator: ".") ⇒ Object
12345678 -> “12,345,678”; the fraction is kept as given.
-
.number_with_precision(number, precision: 3, delimiter: "", separator: ".", strip_insignificant_zeros: false) ⇒ Object
111.2345 -> “111.235”.
Class Method Details
.number_to_currency(number, unit: "$", precision: 2, format: "%u%n", delimiter: ",", separator: ".") ⇒ Object
1234.5 -> “$1,234.50”; a negative number takes “-“ before the format.
100 101 102 103 104 105 106 107 108 109 |
# File 'cybertrain/number_helper.rb', line 100 def self.number_to_currency(number, unit: "$", precision: 2, format: "%u%n", delimiter: ",", separator: ".") d = NumberHelper.parse_number(number, "number_to_currency") NumberHelper.check_precision(precision) places = precision r = NumberHelper.round_places(d, places) shown = Decimal.new(false, r.digits, r.point, 0) amount = NumberHelper.render_fixed(shown, places, delimiter, separator, false) pattern = r.negative ? "-#{format}" : format NumberHelper.fill_currency(pattern, unit, amount) end |
.number_to_human(number, precision: 3, units: {}, format: "%n %u", delimiter: "", separator: ".") ⇒ Object
1234 -> “1.23 Thousand”: precision significant digits, insignificant
zeros stripped; units: { unit:, thousand:, million:, billion:,
trillion:, quadrillion: } replaces the names; format: places the
number (%n) and the unit (%u), the result stripped as Rails strips
it (“123” for a number below a thousand).
58 59 60 61 62 63 64 65 66 67 |
# File 'cybertrain/number_helper.rb', line 58 def self.number_to_human(number, precision: 3, units: {}, format: "%n %u", delimiter: "", separator: ".") names = UNIT_NAMES.dup i = 0 while i < UNIT_KEYS.length custom = units[UNIT_KEYS[i]] names[i] = custom.to_s unless custom.nil? i += 1 end NumberHelper.human_text(number, precision, names, format, delimiter, separator) end |
.number_to_human_size(number) ⇒ Object
1234 -> “1.21 KB” (base 1024, 3 significant digits).
113 114 115 116 117 |
# File 'cybertrain/number_helper.rb', line 113 def self.number_to_human_size(number) names = SIZE_UNITS.dup names[0] = NumberHelper.byte_count(number) == 1 ? "Byte" : "Bytes" NumberHelper.human_size_text(number, 3, names, "%n %u", ".") end |
.number_to_percentage(number, precision: 3, format: "%n%", delimiter: "", separator: ".") ⇒ Object
100 -> “100.000%”; format: places the number (%n).
90 91 92 93 94 95 96 |
# File 'cybertrain/number_helper.rb', line 90 def self.number_to_percentage(number, precision: 3, format: "%n%", delimiter: "", separator: ".") d = NumberHelper.parse_number(number, "number_to_percentage") NumberHelper.check_precision(precision) places = precision r = NumberHelper.round_places(d, places) NumberHelper.fill_currency(format, "", NumberHelper.render_fixed(r, places, delimiter, separator, false)) end |
.number_with_delimiter(number, delimiter: ",", separator: ".") ⇒ Object
12345678 -> “12,345,678”; the fraction is kept as given.
47 48 49 50 |
# File 'cybertrain/number_helper.rb', line 47 def self.number_with_delimiter(number, delimiter: ",", separator: ".") d = NumberHelper.parse_number(number, "number_with_delimiter") NumberHelper.render_fixed(d, d.places, delimiter, separator, false) end |
.number_with_precision(number, precision: 3, delimiter: "", separator: ".", strip_insignificant_zeros: false) ⇒ Object
111.2345 -> “111.235”
37 38 39 40 41 42 43 |
# File 'cybertrain/number_helper.rb', line 37 def self.number_with_precision(number, precision: 3, delimiter: "", separator: ".", strip_insignificant_zeros: false) d = NumberHelper.parse_number(number, "number_with_precision") NumberHelper.check_precision(precision) places = precision r = NumberHelper.round_places(d, places) NumberHelper.render_fixed(r, places, delimiter, separator, strip_insignificant_zeros) end |