sanmai/japanese-numerals

Library to convert Japanese numeral to their Western variants (AKA Hindu-Arabic numerals)

v0.1.3 2024-02-17 10:39 UTC

Requires

• php: >=7.4
• ext-bcmath: *

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2
• php-coveralls/php-coveralls: ^2
• sanmai/phpunit-legacy-adapter: ^6 || ^8

MIT

• ΩF:∅ Open Source Working Group (OFTN Inc.)
• Navarr Barnier
• Alexey Kopytko

README

JapaneseNumeral

Library to convert Japanese numeral to their Western variants (AKA Hindu-Arabic numerals)

Installation is simple:

composer require sanmai/japanese-numerals

Usage

To convert a number from Hindu-Arabic numerals to Japanese numerals, use:

$japanese = \JapaneseNumerals\JapaneseNumerals::fromArabicToJapanese(123);
var_dump($japanese);

Should output:

string(12) "百二十三"

To convert a string of Japanese numerals to Hindu-Arabic numerals, use:

$arabic = \JapaneseNumerals\JapaneseNumerals::fromJapaneseToArabic('二千二十五');
var_dump($arabic);

Should output:

string(4) "2025"

Known bugs

This library isn't bug-free. Most notably it fails to interpret 九百八十三万六千七百三 as 9836703 and 二十億三千六百五十二万千八百一 as 2036521801, examples given in the section on large numbers in the Wikipedia article.

Acknowledgements

Special thanks go to Navarr Barnier (@navarr) for the initial implementation of the algorithm.