Module: ActiveSupport::NumericWithFormat
- Included in:
- BigDecimal, Float, Integer
- Defined in:
- lib/active_support/core_ext/numeric/conversions.rb
Instance Method Summary collapse
-
#to_formatted_s(format = nil, options = nil) ⇒ Object
(also: #to_fs)
Provides options for converting numbers into formatted strings.
Instance Method Details
#to_formatted_s(format = nil, options = nil) ⇒ Object Also known as: to_fs
Provides options for converting numbers into formatted strings. Options are provided for phone numbers, currency, percentage, precision, positional notation, file size and pretty printing.
This method is aliased to to_fs
.
Options
For details on which formats use which options, see ActiveSupport::NumberHelper
Examples
Phone Numbers:
5551234.to_formatted_s(:phone) # => "555-1234"
1235551234.to_formatted_s(:phone) # => "123-555-1234"
1235551234.to_formatted_s(:phone, area_code: true) # => "(123) 555-1234"
1235551234.to_formatted_s(:phone, delimiter: ' ') # => "123 555 1234"
1235551234.to_formatted_s(:phone, area_code: true, extension: 555) # => "(123) 555-1234 x 555"
1235551234.to_formatted_s(:phone, country_code: 1) # => "+1-123-555-1234"
1235551234.to_formatted_s(:phone, country_code: 1, extension: 1343, delimiter: '.')
# => "+1.123.555.1234 x 1343"
Currency:
1234567890.50.to_formatted_s(:currency) # => "$1,234,567,890.50"
1234567890.506.to_formatted_s(:currency) # => "$1,234,567,890.51"
1234567890.506.to_formatted_s(:currency, precision: 3) # => "$1,234,567,890.506"
1234567890.506.to_formatted_s(:currency, round_mode: :down) # => "$1,234,567,890.50"
1234567890.506.to_formatted_s(:currency, locale: :fr) # => "1 234 567 890,51 €"
-1234567890.50.to_formatted_s(:currency, negative_format: '(%u%n)')
# => "($1,234,567,890.50)"
1234567890.50.to_formatted_s(:currency, unit: '£', separator: ',', delimiter: '')
# => "£1234567890,50"
1234567890.50.to_formatted_s(:currency, unit: '£', separator: ',', delimiter: '', format: '%n %u')
# => "1234567890,50 £"
Percentage:
100.to_formatted_s(:percentage) # => "100.000%"
100.to_formatted_s(:percentage, precision: 0) # => "100%"
1000.to_formatted_s(:percentage, delimiter: '.', separator: ',') # => "1.000,000%"
302.24398923423.to_formatted_s(:percentage, precision: 5) # => "302.24399%"
302.24398923423.to_formatted_s(:percentage, round_mode: :down) # => "302.243%"
1000.to_formatted_s(:percentage, locale: :fr) # => "1 000,000%"
100.to_formatted_s(:percentage, format: '%n %') # => "100.000 %"
Delimited:
12345678.to_formatted_s(:delimited) # => "12,345,678"
12345678.05.to_formatted_s(:delimited) # => "12,345,678.05"
12345678.to_formatted_s(:delimited, delimiter: '.') # => "12.345.678"
12345678.to_formatted_s(:delimited, delimiter: ',') # => "12,345,678"
12345678.05.to_formatted_s(:delimited, separator: ' ') # => "12,345,678 05"
12345678.05.to_formatted_s(:delimited, locale: :fr) # => "12 345 678,05"
98765432.98.to_formatted_s(:delimited, delimiter: ' ', separator: ',')
# => "98 765 432,98"
Rounded:
111.2345.to_formatted_s(:rounded) # => "111.235"
111.2345.to_formatted_s(:rounded, precision: 2) # => "111.23"
111.2345.to_formatted_s(:rounded, precision: 2, round_mode: :up) # => "111.24"
13.to_formatted_s(:rounded, precision: 5) # => "13.00000"
389.32314.to_formatted_s(:rounded, precision: 0) # => "389"
111.2345.to_formatted_s(:rounded, significant: true) # => "111"
111.2345.to_formatted_s(:rounded, precision: 1, significant: true) # => "100"
13.to_formatted_s(:rounded, precision: 5, significant: true) # => "13.000"
111.234.to_formatted_s(:rounded, locale: :fr) # => "111,234"
13.to_formatted_s(:rounded, precision: 5, significant: true, strip_insignificant_zeros: true)
# => "13"
389.32314.to_formatted_s(:rounded, precision: 4, significant: true) # => "389.3"
1111.2345.to_formatted_s(:rounded, precision: 2, separator: ',', delimiter: '.')
# => "1.111,23"
Human-friendly size in Bytes:
123.to_formatted_s(:human_size) # => "123 Bytes"
1234.to_formatted_s(:human_size) # => "1.21 KB"
12345.to_formatted_s(:human_size) # => "12.1 KB"
1234567.to_formatted_s(:human_size) # => "1.18 MB"
1234567890.to_formatted_s(:human_size) # => "1.15 GB"
1234567890123.to_formatted_s(:human_size) # => "1.12 TB"
1234567890123456.to_formatted_s(:human_size) # => "1.1 PB"
1234567890123456789.to_formatted_s(:human_size) # => "1.07 EB"
1234567.to_formatted_s(:human_size, precision: 2) # => "1.2 MB"
1234567.to_formatted_s(:human_size, precision: 2, round_mode: :up) # => "1.3 MB"
483989.to_formatted_s(:human_size, precision: 2) # => "470 KB"
1234567.to_formatted_s(:human_size, precision: 2, separator: ',') # => "1,2 MB"
1234567890123.to_formatted_s(:human_size, precision: 5) # => "1.1228 TB"
524288000.to_formatted_s(:human_size, precision: 5) # => "500 MB"
Human-friendly format:
123.to_formatted_s(:human) # => "123"
1234.to_formatted_s(:human) # => "1.23 Thousand"
12345.to_formatted_s(:human) # => "12.3 Thousand"
1234567.to_formatted_s(:human) # => "1.23 Million"
1234567890.to_formatted_s(:human) # => "1.23 Billion"
1234567890123.to_formatted_s(:human) # => "1.23 Trillion"
1234567890123456.to_formatted_s(:human) # => "1.23 Quadrillion"
1234567890123456789.to_formatted_s(:human) # => "1230 Quadrillion"
489939.to_formatted_s(:human, precision: 2) # => "490 Thousand"
489939.to_formatted_s(:human, precision: 2, round_mode: :down) # => "480 Thousand"
489939.to_formatted_s(:human, precision: 4) # => "489.9 Thousand"
1234567.to_formatted_s(:human, precision: 4,
significant: false) # => "1.2346 Million"
1234567.to_formatted_s(:human, precision: 1,
separator: ',',
significant: false) # => "1,2 Million"
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 |
# File 'lib/active_support/core_ext/numeric/conversions.rb', line 111 def to_formatted_s(format = nil, = nil) return to_s if format.nil? case format when Integer, String to_s(format) when :phone ActiveSupport::NumberHelper.number_to_phone(self, || {}) when :currency ActiveSupport::NumberHelper.number_to_currency(self, || {}) when :percentage ActiveSupport::NumberHelper.number_to_percentage(self, || {}) when :delimited ActiveSupport::NumberHelper.number_to_delimited(self, || {}) when :rounded ActiveSupport::NumberHelper.number_to_rounded(self, || {}) when :human ActiveSupport::NumberHelper.number_to_human(self, || {}) when :human_size ActiveSupport::NumberHelper.number_to_human_size(self, || {}) when Symbol to_s else to_s(format) end end |