num2words

📦 num2words — Ruby-гем для преобразования чисел в строковое представление (прописью).

• Поддержка чисел, времени, дат и валют:
  • Integer → 123.to_words(:ru) → "сто двадцать три"
  • Float → 12.5.to_words(:en) → "twelve and five tenths"
  • Time / DateTime → "2024-08-21 14:35:42".to_words(:ru, :time) → "четырнадцать часов тридцать пять минут сорок две секунды"
  • Float.to_currency → 12.5.to_currency(:ru) → "двенадцать рублей пятьдесят копеек"
• Кастомизация вывода:
  • Краткая форма (short: true) → "четырнадцать часов тридцать пять минут"
  • Форматы времени (:hours_only, :hours_minutes, :hours_minutes_seconds)
  • Выбор локали: :ru, :en (из коробки), легко расширить YAML-файлами
• Расширение Integer, Float, Date, Time, DateTime удобными методами.
• Локали инициализируются только при обращении к ним (lazy loading) через lib/num2words/locales.rb.
• Унифицированный Converter, делегирующий работу нужной локали.
• Настраиваемые правила разрядов чисел и валют через I18n YAML.

Добавьте в Gemfile:

gem "num2words"

Или установите напрямую:

gem install num2words

require "num2words"

# Integer
123.to_words(:ru)          # => "сто двадцать три"
123.to_words(:en)          # => "one hundred twenty three"

# Float
45.67.to_words(:ru)        # => "сорок пять целых шестьдесят семь сотых"
45.67.to_words(:en)        # => "forty five and sixty seven hundredths"

21.05.to_currency(:ru)     # => "двадцать один рубль пять копеек"
12.5.to_currency(:en)      # => "twelve dollars fifty cents"

"2024-08-21".to_words(:ru, :date)
# => "двадцать первое августа две тысячи двадцать четвертого года"

"2024-08-21".to_words(:en, :date)
# => "the twenty-first of August, two thousand twenty four"

"14:35:42".to_words(:ru, :time)
# => "четырнадцать часов тридцать пять минут сорок две секунды"

"14:35:42".to_words(:ru, :time, short: true) # или короткая запись: "14:35:42".to_words(:ru, :time, true)
# => "четырнадцать часов тридцать пять минут"

"14:35:42".to_words(:en, :time)
# => "fourteen hours thirty five minutes forty two seconds"

"2024-08-21 14:35:42".to_words(:ru)
# =>  "двадцать первого августа две тысячи двадцать четвёртого года, четырнадцать часов тридцать пять минут сорок две секунды"

"2024-08-21 14:35:42".to_words(:en)
# => "the twenty-first of August, two thousand twenty four at fourteen hours thirty five minutes forty two seconds" 

• locale: :ru | :en — язык (по умолчанию берётся I18n.locale или :ru).
• :date, :time, :datetime — формат преобразования для строк.
• short: true — краткая форма для даты/времени.
• Num2words.to_words(number, locale: :en) — универсальный способ вызова без расширения базовых классов.
• Num2words.to_currency(number) — преобразование число в валюту.

Num2words поддерживает интерактивную консоль для быстрого тестирования.
Это удобно при работе с разными числами и языками.

bin/console

После запуска появится приветственное сообщение:

👋 Добро пожаловать в консоль num2words!
Попробуйте: Num2words.to_words(2025)
-----------------------------------------------------

👉 Это позволяет проверять работу гема без написания отдельных скриптов.

Можно легко добавить новые:

• YAML-файл: config/locales/xx.yml
• Обёртка: lib/num2words/locales/xx.rb

bundle exec rspec

• 🇬🇧 Поддержка английского языка
• 🔠 Опция выбора регистра (строчные/Прописные)
• ⏰ Краткая форма даты/времени
• 💵 Поддержка других валют (USD, EUR и т.д)
• 💰 Краткая форма валюты

MIT