Программный вывод числа прописью: инструментарий Python

Расширенные примеры программного кода

Дополнительные сценарии использования и неочевидные приёмы преобразования чисел в текст.

Пример 1: num2words для разных языков и форматов

Вывод числа на русском, английском и немецком с указанием различных параметров.

from num2words import num2words

# Русский: денежный формат
print(num2words(1234.50, lang='ru', to='currency'))  # одна тысяча двести тридцать четыре рубля 50 копеек

# Английский: порядковое числительное
print(num2words(21, lang='en', ordinal=True))  # twenty-first

# Немецкий: дательный падеж (используется 'der')
print(num2words(1234, lang='de'))  # eintausendzweihundertvierunddreißig

одна тысяча двести тридцать четыре рубля 50 копеек
twenty-first
eintausendzweihundertvierunddreißig

Пример 2: Самописная функция с поддержкой дробной части

Доработка самописной функции для обработки чисел с копейками.

def number_to_words_currency(n):
    # Используем ранее определённую функцию number_to_words_ru для целой части
    rubles = int(n)
    kopecks = int(round((n - rubles) * 100))
    rubles_word = number_to_words_ru(rubles)
    # Склонение слова 'рубль'
    if rubles % 10 == 1 and rubles % 100 != 11:
        rubles_word += ' рубль'
    elif rubles % 10 in [2,3,4] and rubles % 100 not in [12,13,14]:
        rubles_word += ' рубля'
    else:
        rubles_word += ' рублей'
    kopecks_word = f'{kopecks:02d} копеек'
    return f'{rubles_word} {kopecks_word}'

print(number_to_words_currency(1234.56))

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

Пример 3: inflect для порядковых числительных и множественного числа

Генерация корректных фраз с количеством и существительным.

import inflect

p = inflect.engine()

# Число 1000 в словах
print(p.number_to_words(1000))  # one thousand

# 101-й элемент
print(p.number_to_words(101, ordinal=True))  # one hundred and first

# Количество и существительное с учётом числа
print(p.number_to_words(3) + ' ' + p.plural('child', 3))  # three children

one thousand
one hundred and first
three children

Пример 4: num2words для научных и очень больших чисел

Обработка чисел до 10^24 (септиллион) и использование параметра to='year'.

from num2words import num2words

# Огромное число
big_num = 123456789012345678901234
print(num2words(big_num, lang='en'))

# Год (особое произношение)
print(num2words(2025, lang='en', to='year'))  # twenty twenty-five

one hundred twenty-three septillion four hundred fifty-six sextillion seven hundred eighty-nine quintillion twelve quadrillion three hundred forty-five trillion six hundred seventy-eight billion nine hundred one million two hundred thirty-four thousand one hundred twenty-three
twenty twenty-five

Пример 5: Обработка нуля и отрицательных чисел

Разные библиотеки по-разному реагируют на ноль и отрицательные значения.

from num2words import num2words
import inflect

# num2words: ноль
print(num2words(0, lang='ru'))  # ноль

# num2words: отрицательное число (выдаёт ошибку, нужно предварительно обработать)
try:
    print(num2words(-5, lang='ru'))
except OverflowError as e:
    print('Отрицательные числа не поддерживаются:', e)

# inflect: ноль
p = inflect.engine()
print(p.number_to_words(0))  # zero

# inflect: отрицательное – также ошибка
try:
    print(p.number_to_words(-5))
except Exception as e:
    print('Inflect не принимает отрицательные:', e)

ноль
Отрицательные числа не поддерживаются: cannot convert negative number
zero
Inflect не принимает отрицательные: number_to_words() requires a non-negative number

Для работы с отрицательными числами можно взять модуль числа и добавить слово "минус" вручную.