kanjize

What it is and what it does

Kanjize is a bidirectional converter between Japanese kanji number notation and standard integers. It handles both standard and formal (daiji) kanji representations, mixed notation (combining Arabic digits with kanji), and flat digit-by-digit conversion. The package supports numbers up to 10^72 - 1 and includes a Number class for arithmetic operations on kanji-represented values.

The library is useful for applications that need to parse or generate Japanese numerals—common in Japanese text processing, document generation, and localization. It has no external runtime dependencies and requires Python 3.8 or later. The package is stable and maintained, though updates are infrequent.

Use it for:

• Parse Japanese text containing kanji numerals and convert them to integers for calculation or storage
• Generate Japanese kanji number representations for documents, invoices, or formal Japanese text output
• Support mixed notation (e.g., '223兆4千億') for applications that display numbers in hybrid Arabic-kanji format
• Perform arithmetic on kanji-represented numbers using the Number class without converting to integers first
• Localize numeric output in Japanese applications by converting standard integers to formal or casual kanji notation

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts between Japanese kanji number representations and integers, supporting numbers up to 10^72 - 1, with configurable output styles and daiji (formal kanji) variants.

Yes, if you need to work with Japanese kanji numerals. The package is stable, has no dependencies, installs easily, and covers a wide range of conversion scenarios. The infrequent updates are not a concern for a mature, single-purpose library. No known security vulnerabilities.

Install

kanjize on PyPI

pip install kanjize

uv add kanjize

poetry add kanjize

Installing kanjize

Before you install

Low friction install with no runtime dependencies. Marked as aging (426 days since last release), but the repository remains active with recent commits and the package is marked Production/Stable.

License in practice

MIT license (permissive) means you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install kanjize

from kanjize import number2kanji, kanji2number

print(number2kanji(58076099))
# 五千八百七万六千九十九

print(kanji2number("五千八百七万六千九十九"))
# 58076099

Verify before relying

• Whether the package handles edge cases consistently for numbers near the 10^72 - 1 limit
• Performance characteristics when converting very large numbers or bulk operations

Package facts

Evidence: kanjize-1.6.1-py3-none-any.whl

Keywords: converter, integer, japanese, kanji, number

Tags

More Python Modules packages