Spec-Zone.ru › Ruby on Rails 8.1

module ActionView::Helpers::NumberHelper

Вспомогательные методы работы с числами в Action View

Предоставляет методы для преобразования чисел в строки заданного формата. Методы предназначены для телефонных номеров, денежных сумм, процентов, точности, позиционной записи, размеров файлов и удобного вывода.

Большинство методов ожидают аргумент number и возвращают его без изменений, если его не удаётся преобразовать в допустимое число.

Открытые методы экземпляра

number_to_currency (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 55
def number_to_currency(number, options = {})
  delegate_number_helper_method(:number_to_currency, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_currency.

number_to_currency("1234")               # => "$1234.00"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_to_currency("12x34")              # => "$12x34"
number_to_currency("12x34", raise: true) # => InvalidNumberError
number_to_human (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 125
def number_to_human(number, options = {})
  delegate_number_helper_method(:number_to_human, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_human.

number_to_human("1234")               # => "1.23 Thousand"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_to_human("12x34")              # => "12x34"
number_to_human("12x34", raise: true) # => InvalidNumberError
number_to_human_size (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 111
def number_to_human_size(number, options = {})
  delegate_number_helper_method(:number_to_human_size, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_human_size.

number_to_human_size("1234")               # => "1.21 KB"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_to_human_size("12x34")              # => "12x34"
number_to_human_size("12x34", raise: true) # => InvalidNumberError
number_to_percentage (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 69
def number_to_percentage(number, options = {})
  delegate_number_helper_method(:number_to_percentage, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_percentage.

number_to_percentage("99")               # => "99.000%"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_to_percentage("99x")              # => "99x%"
number_to_percentage("99x", raise: true) # => InvalidNumberError
number_to_phone (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 37
def number_to_phone(number, options = {})
  return unless number
  options = options.symbolize_keys

  parse_float(number, true) if options.delete(:raise)
  ERB::Util.html_escape(ActiveSupport::NumberHelper.number_to_phone(number, options))
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_phone.

number_to_phone("1234567890")         # => "123-456-7890"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_to_phone("12x34")              # => "12x34"
number_to_phone("12x34", raise: true) # => InvalidNumberError
number_with_delimiter (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 83
def number_with_delimiter(number, options = {})
  delegate_number_helper_method(:number_to_delimited, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_delimited.

number_with_delimiter("1234")               # => "1,234"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_with_delimiter("12x34")              # => "12x34"
number_with_delimiter("12x34", raise: true) # => InvalidNumberError
number_with_precision (number, options = {}) Показать исходный код
# File actionview/lib/action_view/helpers/number_helper.rb, line 97
def number_with_precision(number, options = {})
  delegate_number_helper_method(:number_to_rounded, number, options)
end

Делегирует вызов ActiveSupport::NumberHelper#number_to_rounded.

number_with_precision("1234")               # => "1234.000"

Кроме того, поддерживается параметр :raise, при наличии которого будет вызвано исключение InvalidNumberError, если number не является допустимым числом:

number_with_precision("12x34")              # => "12x34"
number_with_precision("12x34", raise: true) # => InvalidNumberError

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API