Module: Cybertrain::NumberHelper

Defined in:
cybertrain/number_helper.rb

Class Method Summary collapse

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