Module: RuPropisju

Defined in:
lib/ru_propisju.rb

Overview

Самый лучший, прекрасный, кривой и неотразимый суперпечататель суммы прописью для Ruby.

RuPropisju.rublej(123) # "сто двадцать три рубля"

Defined Under Namespace

Classes: UnknownCurrency, UnknownLocale

Constant Summary collapse

VERSION = 
'2.3.0'
CURRENCIES =

www.xe.com/symbols.php (лица, приближенные форексам и всяким там валютам и курсам) говорят, что код валюты российского рубля - rub

{
  "rur" => :rublej,
  "rub" => :rublej,
  "usd" => :dollarov,
  "uah" => :griven,
  "eur" => :evro,
  "kzt" => :tenge,
}
SUPPORTED_CURRENCIES = 
CURRENCIES.keys.join ','
TRANSLATIONS = 
{
  'ru' => {
    0 => "",
    '0' => "ноль",
    :thousands => ["тысяча", "тысячи", "тысяч"],
    :millions => ["миллион", "миллиона", "миллионов"],
    :billions => ["миллиард", "миллиарда", "миллиардов"],
    100 => "сто",
    200 => "двести",
    300 => "триста",
    400 => "четыреста",
    500 => "пятьсот",
    600 => "шестьсот",
    700 => "семьсот",
    800 => "восемьсот",
    900 => "девятьсот",

    10 => "десять",
    11 => "одиннадцать",
    12 => "двенадцать",
    13 => "тринадцать",
    14 => "четырнадцать",
    15 => "пятнадцать",
    16 => "шестнадцать",
    17 => "семнадцать",
    18 => "восемнадцать",
    19 => "девятнадцать",
    20 => "двадцать",
    30 => "тридцать",
    40 => "сорок",
    50 => "пятьдесят",
    60 => "шестьдесят",
    70 => "семьдесят",
    80 => "восемьдесят",
    90 => "девяносто",
    # единицы, местами - c учетом рода
    1 => {1 => "один", 2 => 'одна', 3 => 'одно'},
    2 => {1 => "два", 2 => 'две', 3 => 'два'},
    3 => "три",
    4 => "четыре",
    5 => "пять",
    6 => "шесть",
    7 => "семь",
    8 => "восемь",
    9 => "девять",
    :rub_integral => ["рубль", "рубля", "рублей"],
    :rub_fraction => ['копейка', 'копейки', 'копеек'],
    :uah_integral => ["гривна", "гривны", "гривен"],
    :uah_fraction => ['копейка', 'копейки', 'копеек'],
    :kzt_integral => ["тенге", "тенге", "тенге"],
    :kzt_fraction => ['тиын', 'тиына', 'тиынов'],
    :eur_integral => ["евро", "евро", "евро"],
    # по опыту моей прошлой работы в банке
    # центами называют дробную часть доллара
    # а дробную часть евро называют евроцентом
    :eur_fraction => ["цент", "цента", "центов"],
    :usd_integral => ["доллар", "доллара", "долларов"],
    :usd_fraction => ['цент', 'цента', 'центов'],
  },
  'ru_in' => { # Предложный падеж, например в 2 городах, поэтому ru_in  - in == 'в' (если нужен будет творительный падеж - делайте ru_from aka из города from == 'из')
    0 => "",
    '0' => "нуле",
    :thousands => ["тысяче", "тысячах", "тысячах"],
    :millions => ["миллионе", "миллионах", "миллионах"],
    :billions => ["миллиарде", "миллиардах", "миллиардах"],
    100 => "ста",
    200 => "двухстах",
    300 => "трёхстах",
    400 => "четырёхстах",
    500 => "пятистах",
    600 => "шестистах",
    700 => "семистах",
    800 => "восьмистах",
    900 => "девятистах",

    10 => "десяти",
    11 => "одиннадцати",
    12 => "двенадцати",
    13 => "тринадцати",
    14 => "четырнадцати",
    15 => "пятнадцати",
    16 => "шестнадцати",
    17 => "семнадцати",
    18 => "восемнадцати",
    19 => "девятнадцати",
    20 => "двадцати",
    30 => "тридцати",
    40 => "сорока",
    50 => "пятьдесяти",
    60 => "шестьдесяти",
    70 => "семьдесяти",
    80 => "восемьдесяти",
    90 => "девяноста",
    # единицы, местами - c учетом рода
    1 => {1 => "одном", 2 => 'одной', 3 => 'одном'},
    2 => {1 => "двух", 2 => 'двух', 3 => 'двух'},
    3 => "трёх",
    4 => "четырёх",
    5 => "пяти",
    6 => "шести",
    7 => "семи",
    8 => "восьми",
    9 => "девяти",
    :rub_integral => ["рубле", "рублях", "рублях"],
    :rub_fraction => ['копейке', 'копейках', 'копейках'],
    :uah_integral => ["гривне", "гривнах", "гривнах"],
    :uah_fraction => ['копейке', 'копейках', 'копейках'],
    :kzt_integral => ["тенге", "тенге", "тенге"],
    :kzt_fraction => ['тиыне', 'тиынах', 'тиынах'],
    :eur_integral => ["евро", "евро", "евро"],
    # по опыту моей прошлой работы в банке
    # центами называют дробную часть доллара
    # а дробную часть евро называют евроцентом
    :eur_fraction => ["центе", "центах", "центах"],
    :usd_integral => ["долларе", "долларах", "долларах"],
    :usd_fraction => ['центе', 'центах', 'центах'],
  },
  'ua' => {
    0 => "",
    '0' => "нуль",
    :thousands => ["тисяча", "тисячі", "тисяч"],
    :millions => ["мільйон", "мільйона", "мільйонів"],
    :billions => ["мільярд", "мільярда", "мільярдів"],
    100 => "сто",
    200 => "двісті",
    300 => "триста",
    400 => "чотириста",
    500 => "п'ятьсот",
    600 => "шістсот",
    700 => "сімсот",
    800 => "вісімсот",
    900 => "дев'ятсот",

    10 => "десять",
    11 => "одинадцять",
    12 => "дванадцять",
    13 => "тринадцять",
    14 => "чотирнадцять",
    15 => "п'ятнадцять",
    16 => "шістнадцять",
    17 => "сімнадцять",
    18 => "вісімнадцять",
    19 => "дев'ятнадцять",
    20 => "двадцять",
    30 => "тридцять",
    40 => "сорок",
    50 => "п'ятьдесят",
    60 => "шістдесят",
    70 => "сімдесят",
    80 => "вісімдесят",
    90 => "дев'яносто",
    # единицы, местами - c учетом рода
    1 => {1 => "один", 2 => 'одна', 3 => 'одне'},
    2 => {1 => "два", 2 => 'дві', 3 => 'два'},
    3 => "три",
    4 => "чотири",
    5 => "п'ять",
    6 => "шість",
    7 => "сім",
    8 => "вісім",
    9 => "дев'ять",
    :rub_integral => ["рубль", "рубля", "рублів"],
    :rub_fraction => ['копійка', 'копійки', 'копійок'],
    :uah_integral => ["гривня", "гривні", "гривень"],
    :uah_fraction => ["копійка", "копійки", "копійок"],
    :kzt_integral => ["тенге", "тенге", "тенге"],
    :kzt_fraction => ['тиын', 'тиына', 'тиынов'],
    :eur_integral => ["євро", "євро", "євро"],
    :eur_fraction => ["євроцент", "євроцента", "євроцентів"],
    :usd_integral => ["долар", "долара", "доларів"],
    :usd_fraction => ['цент', 'цента', 'центів'],
  }
}
MONEY_GENDERS = 
{
  :rub => 1,
  :usd => 1,
  :uah => 2,
  :eur => 1,
  :kzt => 1,
}

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.compose_ordinal(remaining_amount_or_nil, gender, item_forms = [], locale = :ru) ⇒ Object

Cоставляет число прописью для чисел до тысячи



401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
 
# File 'lib/ru_propisju.rb', line 401

def compose_ordinal(remaining_amount_or_nil, gender, item_forms = [], locale = :ru)
  
  remaining_amount = remaining_amount_or_nil.to_i
  
  locale = locale.to_s
  
  # Ноль чего-то
  # return "ноль %s" % item_forms[3] if remaining_amount_or_nil.zero?
  
  rest, rest1, chosen_ordinal, ones, tens, hundreds = [nil]*6
  
  rest = remaining_amount  % 1000
  remaining_amount = remaining_amount / 1000
  if rest.zero?
    # последние три знака нулевые
    return item_forms[2]
  end

  locale_root = pick_locale(TRANSLATIONS, locale)
  
  # начинаем подсчет с Rest
  # сотни
  hundreds = locale_root[(rest / 100).to_i * 100]

  # десятки
  rest = rest % 100
  rest1 = rest / 10

  # единички
  ones = ""
  tens = locale_root[rest1 == 1 ? rest : rest1 * 10]

  # индекс выбранной формы
  chosen_ordinal = 2
  if rest1 < 1 || rest1 > 1 # единицы
    value = locale_root[rest % 10]
    # если попался хэш, делаем выбор согласно рода
    value = value[gender] if value.kind_of? Hash
    ones = value
    case rest % 10
      when 1 then chosen_ordinal = 0 # индекс формы меняется
      when 2..4 then chosen_ordinal = 1 # индекс формы меняется
    end
  end
  plural = [
    hundreds,
    tens,
    ones,
    item_forms[chosen_ordinal],
  ].compact.reject(&:empty?).join(' ').strip
  
  return plural
end

.pick_locale(from_hash, locale) ⇒ Object

Raises:



585
586
587
588
 
# File 'lib/ru_propisju.rb', line 585

def pick_locale(from_hash, locale)
  return from_hash[locale.to_s] if from_hash.has_key?(locale.to_s)
  raise UnknownLocale, "Unknown locale #{locale.inspect}"
end

.propisju_float(num, locale = :ru) ⇒ Object

Выдает сумму прописью с учетом дробной доли. Дробная доля округляется до миллионной, или (если дробная доля оканчивается на нули) до ближайшей доли или точки ( 500 тысячных округляется до 5 десятых, 30.0000 до 30).



514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
 
# File 'lib/ru_propisju.rb', line 514

def propisju_float(num, locale = :ru)
  locale_root = pick_locale(DECIMALS, locale)
  source_expression = locale_root[:prefix][0]
  target_prefix = locale_root[:prefix][1]
  words = locale_root[:source_words].map do |e|
    [
      e,
      e.gsub(/#{source_expression}$/, target_prefix),
      e.gsub(/#{source_expression}$/, target_prefix),
    ]
  end.freeze

  # Укорачиваем до триллионной доли
  formatted = num.to_s[/^\d+(\.\d{0,#{words.length}})?/].gsub(/0+$/, '')
  wholes, decimals = formatted.split(".")

  return propisju_int(wholes.to_i, 1, [], locale) if decimals.to_i.zero?

  whole_st = propisju_shtuk(wholes.to_i, 2, words[0], locale)

  rem_st = propisju_shtuk(decimals.to_i, 2, words[decimals.length], locale)
  [whole_st, rem_st].compact.join(" ")
end

.propisju_int(amount, gender = 1, item_forms = [], locale = :ru) ⇒ Object

Выполняет преобразование числа из цифрого вида в символьное

amount - числительное
gender   = 1 - мужской, = 2 - женский, = 3 - средний
one_item - именительный падеж единственного числа (= 1)
two_items - родительный падеж единственного числа (= 2-4)
five_items - родительный падеж множественного числа ( = 5-10)

Примерно так:

propisju(42, 1, ["сволочь", "сволочи", "сволочей"]) # => "сорок две сволочи"



548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
 
# File 'lib/ru_propisju.rb', line 548

def propisju_int(amount, gender = 1, item_forms = [], locale = :ru)
  
  locale_root = pick_locale(TRANSLATIONS, locale)
  
  # zero!
  if amount.zero?
    return [locale_root['0'], item_forms[-1]].compact.join(' ')
  end
  
  fractions = [
    [:trillions, 1_000_000_000_000],
    [:billions, 1_000_000_000],
    [:millions, 1_000_000],
    [:thousands, 1_000],
  ]
  
  parts = fractions.map do | name, multiplier |
    [name, fraction = (amount / multiplier) % 1000]
  end
  
  # Единицы обрабатываем отдельно
  ones = amount % 1000
  
  # Составляем простые тысячные доли
  parts_in_writing = parts.reject do | part |
    part[1].zero?
  end.map do | name, fraction |
    thousandth_gender = (name == :thousands) ? 2 : 1
    compose_ordinal(fraction, thousandth_gender, locale_root[name], locale)
  end
  
  # И только единицы обрабатываем с переданными параметрами
  parts_in_writing.push(compose_ordinal(ones, gender, item_forms, locale))
  
  parts_in_writing.compact.join(' ')
end

.zero(locale_data, integrals, fractions, fraction_as_number, integrals_as_number) ⇒ Object 



392
393
394
395
396
397
 
# File 'lib/ru_propisju.rb', line 392

def zero(locale_data, integrals, fractions, fraction_as_number, integrals_as_number)
  integ = integrals_as_number ? '0' : locale_data['0']
  frac = fraction_as_number ? '0' : locale_data['0']
  parts = [integ , integrals[-1], frac, fractions[-1]]
  parts.join(' ')
end

Instance Method Details

#amount_in_words(amount, currency, locale = :ru) ⇒ Object

Выводит сумму прописью в зависимости от выбранной валюты. Поддерживаемые валюты: rur, usd, uah, eur

amount_in_words(345.2, 'rur') #=> "триста сорок пять рублей 20 копеек"



240
241
242
243
244
245
246
 
# File 'lib/ru_propisju.rb', line 240

def amount_in_words(amount, currency, locale = :ru)
  currency = currency.to_s.downcase
  unless CURRENCIES.has_key? currency
    raise UnknownCurrency, "Unsupported currency #{currency}, the following are supported: #{SUPPORTED_CURRENCIES}"
  end
  method(CURRENCIES[currency]).call(amount, locale)
end

#choose_plural(amount, *variants) ⇒ Object

Выбирает нужный падеж существительного в зависимости от числа

choose_plural(3, "штука", "штуки", "штук") #=> "штуки"



219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
 
# File 'lib/ru_propisju.rb', line 219

def choose_plural(amount, *variants)
  variants = variants.flatten
  
  mod_ten = amount % 10
  mod_hundred = amount % 100
  variant = if (mod_ten == 1 && mod_hundred != 11)
      1
  else
    if mod_ten >= 2 && mod_ten <= 4 && (mod_hundred <10 || mod_hundred % 100>=20)
      2
    else
      3
    end
  end
  variants[variant-1]
end

#digit_rublej(amount, locale = :ru) ⇒ Object

Выводит целое или дробное число как сумму в рублях и копейках не прописью

digit_rublej(345.2) #=> "345 рублей 20 копеек"



273
274
275
276
277
278
279
 
# File 'lib/ru_propisju.rb', line 273

def digit_rublej(amount, locale = :ru)
  integrals_key = :rub_integral
  fractions_key = :rub_fraction
  money_gender = MONEY_GENDERS[:rub]

  money(amount, locale, integrals_key, fractions_key, money_gender, true, true)
end

#dollarov(amount, locale = :ru) ⇒ Object Also known as: dollar, dollary

Выводит целое или дробное число как сумму в долларах прописью

dollarov(32) #=> "тридцать два доллара"



306
307
308
309
310
311
312
 
# File 'lib/ru_propisju.rb', line 306

def dollarov(amount, locale = :ru)
  integrals_key = :usd_integral
  fractions_key = :usd_fraction
  money_gender = MONEY_GENDERS[:usd]

  money(amount, locale, integrals_key, fractions_key, money_gender)
end

#evro(amount, locale = :ru) ⇒ Object

Выводит целое или дробное число как сумму в евро прописью

evro(32) #=> "тридцать два евро"



317
318
319
320
321
322
323
 
# File 'lib/ru_propisju.rb', line 317

def evro(amount, locale = :ru)
  integrals_key = :eur_integral
  fractions_key = :eur_fraction
  money_gender = MONEY_GENDERS[:eur]

  money(amount, locale, integrals_key, fractions_key, money_gender)
end

#griven(amount, locale = :ru) ⇒ Object Also known as: grivna, grivny

Выводит целое или дробное число как сумму в гривнах прописью

griven(32) #=> "тридцать две гривны"



295
296
297
298
299
300
301
 
# File 'lib/ru_propisju.rb', line 295

def griven(amount, locale = :ru)
  integrals_key = :uah_integral
  fractions_key = :uah_fraction
  money_gender = MONEY_GENDERS[:uah]

  money(amount, locale, integrals_key, fractions_key, money_gender)
end

#kopeek(amount, locale = :ru) ⇒ Object Also known as: kopeika, kopeiki

Выводит сумму прописью в рублях по количеству копеек

kopeek(343) #=> "три рубля 43 копейки"



339
340
341
 
# File 'lib/ru_propisju.rb', line 339

def kopeek(amount, locale = :ru)
  rublej(amount / 100.0, locale)
end

#money(amount, locale, integrals_key, fractions_key, money_gender, fraction_as_number = false, integrals_as_number = false) ⇒ Object 



357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
 
# File 'lib/ru_propisju.rb', line 357

def money(amount, locale, integrals_key, fractions_key, money_gender, fraction_as_number = false, integrals_as_number = false)
  locale_data = pick_locale(TRANSLATIONS, locale)
  integrals = locale_data[integrals_key]
  fractions = locale_data[fractions_key]

  return zero(locale_data, integrals, fractions, fraction_as_number, integrals_as_number) if amount.zero?

  parts = []
  if integrals_as_number
    parts << amount.to_i << choose_plural(amount, integrals) unless amount.to_i == 0
  else
    parts << propisju_int(amount.to_i, money_gender, integrals, locale) unless amount.to_i == 0
  end

  if amount.kind_of?(Float)
    remainder = (amount.divmod(1)[1]*100).round
    if remainder == 100
      parts = [propisju_int(amount.to_i + 1, money_gender, integrals, locale)]
    else
      if fraction_as_number
        kop = remainder.to_i
        unless kop.zero?
          parts << kop << choose_plural(kop, fractions)
        end
      else
        parts << propisju_int(remainder.to_i, money_gender, fractions, locale)
      end
    end
  end

  parts.join(' ')
end

#propisju(amount, gender, locale = :ru) ⇒ Object

Выбирает корректный вариант числительного в зависимости от рода и числа и оформляет сумму прописью

propisju(243, 1) => "двести сорок три"
propisju(221, 2) => "двести двадцать одна"



284
285
286
287
288
289
290
 
# File 'lib/ru_propisju.rb', line 284

def propisju(amount, gender, locale = :ru)
  if amount.is_a?(Integer) || amount.is_a?(Bignum)
    propisju_int(amount, gender, [], locale)
  else # также сработает для Decimal, дробные десятичные числительные в долях поэтому женского рода
    propisju_float(amount, locale)
  end
end

#propisju_shtuk(items, gender, forms, locale = :ru) ⇒ Object

Выводит сумму данного существительного прописью и выбирает правильное число и падеж

RuPropisju.propisju_shtuk(21, 3, "колесо", "колеса", "колес") #=> "двадцать одно колесо"
RuPropisju.propisju_shtuk(21, 1, "мужик", "мужика", "мужиков") #=> "двадцать один мужик"



347
348
349
350
351
352
353
354
355
 
# File 'lib/ru_propisju.rb', line 347

def propisju_shtuk(items, gender, forms, locale = :ru)
  elements = if (items == items.to_i)
    [propisju(items, gender, locale), choose_plural(items, forms)]
  else
    [propisju(items, gender, locale), forms[1]]
  end
  
  elements.join(" ")
end

#rublej(amount, locale = :ru) ⇒ Object Also known as: rublja, rubl

Выводит целое или дробное число как сумму в рублях прописью

rublej(345.2) #=> "триста сорок пять рублей 20 копеек"



252
253
254
255
256
257
258
 
# File 'lib/ru_propisju.rb', line 252

def rublej(amount, locale = :ru)
  integrals_key = :rub_integral
  fractions_key = :rub_fraction
  money_gender = MONEY_GENDERS[:rub]

  money(amount, locale, integrals_key, fractions_key, money_gender, true)
end

#rublej_extended_format(amount, locale = :ru) ⇒ Object

Выводит целое или дробное число как сумму в расширенном формате

rublej_extended_format(345.2) #=> "345 рублей 20 копеек (триста сорок пять рублей 20 копеек)"



264
265
266
 
# File 'lib/ru_propisju.rb', line 264

def rublej_extended_format(amount, locale = :ru)
  "#{digit_rublej(amount, locale)} (#{rublej(amount, locale)})"
end

#tenge(amount, locale = :ru) ⇒ Object

Выводит целое или дробное число как сумму в тенге прописью

tenge(32) #=> "тридцать два тенге"



328
329
330
331
332
333
334
 
# File 'lib/ru_propisju.rb', line 328

def tenge(amount, locale = :ru)
  integrals_key = :kzt_integral
  fractions_key = :kzt_fraction
  money_gender = MONEY_GENDERS[:kzt]

  money(amount, locale, integrals_key, fractions_key, money_gender)
end